← Back to Documentation Home

The Events & Registration module lets your church organize and track events of all kinds — from weekly services and Bible studies to one-time retreats and conferences. Members can browse a calendar of upcoming events, while admins can create events, manage registrations, and define locations.

Events Calendar

The Events page shows a full monthly calendar view. All users can browse events connected to their groups and registrations.

Navigating the Calendar

  1. Open Events from the left sidebar menu.
  2. The current month is displayed as a grid. Today's date is highlighted with a blue circle so you can orient yourself quickly.
  3. Use the left and right arrow buttons above the calendar to move to the previous or next month.
  4. Tap the Today button to jump back to the current month at any time.
  5. Days that have events show a small indicator. Tap on any day to see the list of events for that date.
Tip: The calendar shows events from groups you belong to and events you have registered for. If you don't see an event you expect, make sure you are a member of the group hosting it.

Calendar Controls

Month Navigation

Arrow buttons step forward or backward through the calendar (one month, one week, or one day depending on the active view).

Today Button

Returns the view to the current date, regardless of how far you have navigated.

Day Selection

Tap any day cell to expand the event list for that date below the calendar.

Calendar Views

The calendar supports four view modes. Switch between them using the view toggle tabs above the calendar. Your preferred view is remembered between sessions.

Month View

The default view — a traditional monthly grid with colored event chips on each day. Sunday events with multiple time slots are rolled up into compact chips (e.g., "8:30 AM Sunday Service", "10:30 AM Sunday Service") to save space. Click any day to see its full event list below the grid.

Month view showing colored event chips on a calendar grid

Month view — colored chips show events on each day

Week View

A 7-column time grid showing one week at a time. Each column represents a day (Sunday through Saturday), with events positioned as blocks according to their start and end times. The grid spans 6 AM to 10 PM.

  • Events appear as colored blocks spanning their actual duration
  • Click a day column header to switch to Day view for that date
  • Navigate by week using the arrow buttons
Week view with event blocks positioned on a 7-column time grid

Week view — events positioned as blocks across a 7-day time grid

Day View

A single-column time grid for one day. Overlapping events are arranged side by side in multiple columns so nothing is hidden. Ideal for seeing the full schedule of a busy day at a glance.

  • Click any empty time slot to create a new event starting at that time (admin only)
  • Overlapping events display in adjacent columns so all are visible
  • Navigate day by day using the arrow buttons
Day view showing a single-column time grid with events

Day view — single-day time grid with events

Agenda View

A flat, scrollable list of events organized by date — the simplest way to see what is coming up. Shows approximately 1 month of past events and 3 months of future events. Each event card shows the name, time, location, and a one-line description preview (if available).

Agenda view with expanded sidebar showing all module navigation and chronological event list

Agenda view with the sidebar expanded — chronological event list with full navigation visible

View Comparison

ViewBest ForNavigation
MonthOverview of the full month, seeing which days have eventsPrev/next month, month picker, Today
WeekPlanning a specific week, seeing time-of-day layoutPrev/next week, Today
DayDetailed view of one day, finding open time slotsPrev/next day, Today
AgendaQuick scan of upcoming events in a simple listScroll (loads 1 month past + 3 months future)
Tip: Your selected view is saved in your browser. The next time you visit the Events page, it will open to whichever view you used last.

Event Details

To view details for any event:

  1. Click on a day cell in the calendar — the events for that day expand below the calendar grid.
  2. Click on an event row in the day list — a detail modal opens with full event information.
Calendar with a day selected and the event list expanded below showing Time, Event, Location, and Group columns

Click a day on the calendar to see its events listed below

What You Will See

FieldDescription
Event NameThe title of the event (e.g., "Sunday Children's Ministry", "Thursday Prayer")
Date & TimeStart and end date/time for the event
LocationWhere the event takes place (room, building, and capacity if set)
GroupThe church group associated with this event, if any
DescriptionAdditional information about the event provided by the organizer
RegistrationWhether registration is open and how many people have signed up

Attendance & No-Shows (Past Events)

For past events, the detail modal automatically shows attendance derived from kiosk check-in records:

  • Attended: N — people who checked in via the kiosk
  • No-show: N — people who registered but did not check in
  • Registered: N — total registration count

Each person is listed with their name, avatar photo, and a colored badge indicating whether they attended or were a no-show. This gives leaders a quick snapshot of actual turnout vs. registrations.

Event detail modal showing attendance counts, attendee list with Attended badges, and no-show indicator

Event detail modal — attendance summary and per-person badges

Future events show registrations only — attendance data appears after the event has passed and people have checked in.
Registration: If an event has a linked registration form, you can sign up directly from the event details. See the user manual section on Sign Up for Events (Form Registration) for step-by-step instructions.

Who Can Access What

Access to event features is controlled by granular permissions:

PermissionWhat It Grants
events.viewView all events on the calendar, including events outside your own groups
events.createCreate new events
events.editEdit existing events
events.deleteDelete events
events.manageFull event management (superset of create + edit + delete + registration and location management)

All authenticated users can browse and view events they are connected to via group membership. The admin features below require the appropriate event permissions.

← Back to Documentation Home

Event Management Admin

Users with event permissions (events.create, events.edit, events.delete, or events.manage) can create, edit, and delete events from the Events management page. This is where you build your church's event schedule.

Creating a New Event

  1. Navigate to the Events page from the sidebar.
  2. Tap + New Event at the top of the event list.
  3. Fill in the event name. This is the title that will appear on the calendar and in event listings.
  4. Set the Start Date/Time and End Date/Time. These define when the event runs and when check-in is available.
  5. Select a Location from the dropdown (optional). Locations are managed separately — see the Locations section below.
  6. Select a Group from the dropdown (optional). Linking an event to a group means that group's members will see the event on their calendar and can be checked in.
  7. Optionally link a Form for registration. This connects an existing registration form so people can sign up.
  8. Add a Description with any additional details attendees should know.
  9. Tap Save to create the event.

Check-In Window Settings

Each event has an implicit check-in window based on its start and end times. The kiosk and check-in system use these times to determine when people can check in. Events only appear for check-in during their active window.

Important: If you set the start time too narrowly, people arriving early will not see the event at the kiosk. Consider setting the start time to allow for early arrivals (e.g., 30 minutes before the actual event begins).

Editing an Event

  1. Find the event in the event list (use the search bar to filter by name).
  2. Tap on the event to open the detail/edit panel on the right side.
  3. Modify any fields: name, date/time, location, group, form, or description.
  4. Tap Save to apply changes.

Deleting an Event

  1. Select the event you want to delete.
  2. Tap Delete at the bottom of the edit panel.
  3. Confirm the deletion when prompted. This action cannot be undone.
Caution: Deleting an event also removes all check-in records and registrations associated with it. Consider whether you need to keep historical data before deleting.
← Back to Documentation Home

Event Descriptions Admin

Events can include a text description to provide attendees with additional context — directions, what to bring, special instructions, or any other relevant details.

Adding a Description

  1. When creating or editing an event, use the Description textarea field.
  2. Enter any relevant details. The description supports plain text with line breaks preserved.
  3. Save the event. The description appears in the event detail modal when users click on the event.

Where Descriptions Appear

  • Event detail modal — clicking an event on the calendar shows the full description (pre-formatted with line breaks)
  • Agenda view — a one-line preview of the description appears below each event card for quick scanning
  • Add/edit event forms — the full description textarea is available when creating new events or editing existing ones
Tip: Keep descriptions concise. The first line is shown as a preview in Agenda view, so put the most important information first.

Recurring Events Admin

For events that happen on a regular schedule (weekly services, monthly meetings, etc.), you can create recurring events instead of entering each date individually.

Recurrence Types

TypeDescription
DailyRepeats every day
WeekdaysRepeats Monday through Friday
SundaysRepeats every Sunday
WeeklyRepeats on the same day each week
Bi-WeeklyRepeats every two weeks
MonthlyRepeats on the same day each month

Creating a Recurring Event

  1. Start creating a new event as described above (name, time, location, group).
  2. In the Recurrence section, select the recurrence type from the dropdown (e.g., Weekly, Monthly).
  3. Choose a stop condition: either a specific number of occurrences (e.g., 10 sessions) or an end date after which no more events are generated.
  4. Tap Save. The system creates all individual event occurrences at once, linked together by a shared recurrence_group_id.

How Recurring Events Work

Each occurrence is a separate event in the database, but they are linked together as a series. This means:

  • Each occurrence can be edited individually (e.g., cancel one session without affecting the rest).
  • When editing a recurring event, you can choose to apply changes to just the selected occurrence or to all future occurrences in the series.
  • The series indicator appears on each event showing it is part of a recurring group.

Managing a Series

Extend Series

Add more occurrences to an existing series by count or by end date. New events inherit the same settings.

Trim Series

Remove future occurrences after a given date. Past events are preserved.

Convert to Recurring

Turn a one-time event into a recurring series by selecting a recurrence type and stop condition.

Tip: You can see how many occurrences exist in a series and their date range in the series information panel that appears when you select a recurring event.
← Back to Documentation Home

Registration Management Admin

When events have linked registration forms, admins can view and manage who has signed up.

Viewing Registrations

  1. Select an event that has a linked registration form.
  2. The registration count is displayed in the event details, showing how many people have signed up.
  3. The attendee list shows each registered person with their name and registration details.

Registration Information

DetailDescription
Registrant NameFull name of each person registered for the event
Registration DateWhen the person signed up
Registration CountTotal number of people registered for the event
Form ResponsesAnswers to any custom questions included on the registration form

Attendance Tracking

Attendance is tracked automatically through the kiosk check-in system — no manual entry is needed. When people check in at the kiosk, their attendance is recorded against the event. Admins can then view attendance for any past event by clicking it on the calendar (see Event Details above for the attendance summary and badge display).

Note: Attendance reports with trends over time are available in the Reports module.

Locations Admin

Locations define the physical spaces where events take place. Each event can be assigned a location so attendees know where to go and admins can manage room capacity.

Location Properties

FieldDescription
NameThe display name of the location (e.g., "Main Sanctuary", "Room 201")
RoomSpecific room identifier within a building
BuildingThe building where this room is located
CapacityMaximum number of people the space can hold (optional)

Creating a Location

  1. Navigate to the location management area (accessible from event creation or the admin settings).
  2. Tap + Add Location.
  3. Enter the location name. This is what users will see when browsing events.
  4. Optionally fill in the room, building, and capacity fields.
  5. Tap Save to create the location.

Editing a Location

  1. Find the location in the list.
  2. Tap to open the edit view.
  3. Update any fields as needed.
  4. Tap Save to apply changes.

Deleting a Location

  1. Select the location to delete.
  2. Tap Delete.
  3. Confirm the deletion. Events that were using this location will have their location cleared.
Tip: Set up all your regular locations (sanctuary, classrooms, fellowship hall, etc.) before creating events. This saves time since you can quickly select from the dropdown instead of typing room details each time.
← Back to Documentation Home