> For the complete documentation index, see [llms.txt](https://help.steeple.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.steeple.com/en/events/application-events.md).

# Events app — Event management

### Overview

**Events** is Steeple's events management application. It allows you to create and manage company events (meetings, ceremonies, seminars, etc.), collect responses (RSVP), and display employees' birthdays and work anniversaries.

The application is accessible from Steeple's main menu. If it does not appear, check its visibility in **Administration** > **Apps** (`/administration/apps`).

### Home view

The home page displays upcoming events grouped by period:

* **Today** : today's events, birthdays, and work anniversaries
* **This week** : events until Sunday
* **This month** : remaining events for the current month
* **Following months** : future events grouped by month

Multi-day events remain in the "Today" section as long as they are ongoing.

#### Filters and search

* **Filter by community** : show only events from one or more communities
* **Search** : real-time search by event title

### Create an event

To create an event, click **Create an event** from the home page.

#### Form fields

* **Title** (required)
* **Description** (optional) — rich text editor
* **Start date and time** (required) — default: tomorrow at the next hour
* **End date and time** (optional) — default: 1 hour after the start
* **All day** — disables time selection
* **Location** (optional)
* **Image** (optional) — photo or visual to illustrate the event

#### Visibility and communities

* By default, the event is visible to **the entire organization**
* Option to restrict to **specific communities** : only members of these communities will see the event

#### Participation

* **Participation enabled** default: employees can answer Yes, No, or Maybe
* **Responder visibility** enabled by default: all participants can see who answered what
* The creator can disable participation (informational event only)
* The creator can hide the list of respondents (for example, for a surprise effect)

#### After creation

You are offered to share the event on the news feed (News) to maximize its visibility.

### Edit an event

* Only the **creator** or an **administrator** can edit an event
* Existing responses are not affected by the edit
* A past (archived) event can no longer be edited
* If the date changes, it is recommended to inform participants via a post

### Delete an event

* Only the **creator** or an **administrator** can delete an event
* Deletion is **permanent** and deletes all associated responses
* Confirmation is requested before deletion

### Participation (RSVP)

#### Respond to an event

* Three possible choices: **Yes**, **No** or **Maybe**
* The response can be changed at any time as long as the event has not passed
* Once the event is over, responses are locked

#### View participants

* If responder visibility is enabled: all employees can see the list
* If visibility is disabled: only the creator and administrators can see the list
* The list is organized by response status (Yes / No / Maybe) with the total number per status

### Share an event

* **On the news feed** : create a post linked to the event, with a direct access button
* **Copy link** : get the event URL (the link requires Steeple authentication; it does not work for external people)

### Past events

* The page **Past events** displays the history of completed events
* Filtering by **year** (year picker)
* **Search** in past events
* Past responses remain viewable

### Birthdays

* Displays employees' birthdays whose **date of birth** is filled in on their profile
* Grouped by month, from soonest to farthest away
* Ability to**send wishes** for today's birthdays (sent via Steeple messaging)
* Birthdays on non-working days are still displayed
* **February 29** : people born on February 29 see their birthday displayed on **March 1** in non-leap years

The birthdays feature can be disabled by the administrator in the settings.

### Seniority

* Displays work anniversary dates
* Requires the **start date** to be filled in on the employee's profile
* Grouped by month with an indication of the number of years of seniority
* Ability to**send congratulations** for today's work anniversaries

### Settings (administration)

Accessible from the page **Settings** of the Events application (requires the administrator/manager role).

#### Event creation rights

* **All members** (default): all employees can create events
* **Administrators only** : only administrators can create events

#### Birthdays

* Enable or disable birthday display for the entire organization
* When disabled: the Birthdays page, widgets, and birthday sections are hidden

### Permissions

| Action                            | Member                        | Event creator         | Administrator         |
| --------------------------------- | ----------------------------- | --------------------- | --------------------- |
| See events from their communities | Yes                           | Yes                   | Yes                   |
| Create an event                   | According to settings         | According to settings | Yes                   |
| Edit an event                     | No                            | Yes (except archived) | Yes (except archived) |
| Delete an event                   | No                            | Yes                   | Yes                   |
| Participate (RSVP)                | Yes (if enabled and not past) | Yes                   | Yes                   |
| See participants                  | If visibility enabled         | Yes                   | Yes                   |
| See view statistics               | No                            | Yes                   | Yes                   |
| Manage Events settings            | No                            | No                    | Yes                   |

### Quotas (freemium plan)

Organizations on a free plan have a limited number of upcoming events. Once the quota is reached, it is no longer possible to create new events until existing events have passed or been deleted. A subscription removes this limit.

### TV display

Events are displayed on Steeple TV screens. The TV display offers:

* The list of upcoming events
* The details of an event with the possibility to participate (via an authenticated session)

### What the assistant can do

The assistant can directly manage events via its tools:

* **List** upcoming and past events
* **View** the details of an event (date, location, description, participants)
* **Create** an event with title, dates, location, communities, participation settings
* **Edit** an existing event
* **Delete** an event
* **Manage responses** : register/unregister, view responses
* **Check the visibility** of the Events application and hide/show it

For the application's administration settings (creation rights, birthdays), guide the user to the Events application Settings page.
