> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> View, create, and manage CE marketing events with registration tracking and campaign association.

The Events screen lists and manages marketing events for the current organization. It is accessible at `/ce/events`.

## Overview

The Events screen renders a card grid of events filtered by a text search and a status dropdown (Scheduled, In Progress, Completed, Cancelled, or All Statuses). Each event card shows the event name, status badge (color-coded), event type, start date/time, location (or "Virtual Event" with a video icon), registered count and optional max attendees, and the linked campaign name if one is associated. Clicking New Event opens `EventFormDialog`. Events are fetched scoped to the current organization.

## Who it's for

Required permission: `ce.events.view` (route-level gate). Creating events likely requires additional write permissions (SME: confirm exact create permission from `EventFormDialog`).

## Before you start

* You need the `ce.events.view` permission.

## Steps

<Steps>
  <Step title="Open Events">Navigate to `/ce/events` via the Community Engagement menu.</Step>
  <Step title="Filter events">Use the search input or the Status dropdown to narrow the event list.</Step>
  <Step title="Create an event">Click New Event to open the event form dialog and fill in event details.</Step>
  <Step title="Review an event card">Each card shows the event status, type, date/time, location or virtual flag, registration count, and linked campaign.</Step>
</Steps>

## Key concepts

* **Event type** — determined by `EVENT_TYPE_LABELS` constants (SME: confirm available types).
* **Event status** — `scheduled`, `in_progress`, `completed`, `cancelled`.
* **Virtual events** — indicated by a video icon and "Virtual Event" label rather than a map pin and location name.
* **Campaign linkage** — an event card shows the linked campaign name when `event.campaign` is present.

## Viewing an event

The route `/ce/events/:id` is not registered as a standalone screen in the current CE route configuration. As of the current codebase, `/ce/events/:id` does not map to a registered route in `src/routes/ce.tsx`. Events are created and managed through the `EventFormDialog` on the `/ce/events` list screen (`EventsPage`). Event cards on the list page show name, type, status, date, location (or virtual indicator), registration count, and linked campaign. No click-through navigation to a detail route is implemented in the list. Visiting `/ce/events/:id` currently falls through to the platform's Not Found handler.

## Related

<Columns cols={2}>
  <Card title="Community Engagement" icon="bullhorn" href="/ce/overview">
    Community Engagement core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/ce.tsx
  * src/cores/ce/pages/EventsPage.tsx
</Accordion>