Search and Select Multiple Participants for an Event

The Event Participants Widget renders a debounced search input that queries the Contact Repository against the user's organization-scoped contact list. Results appear as selectable cards; selected participants appear as removable chips above the search field. The widget is available both during the creation wizard (as a dedicated step after the summary) and on the Event Detail Screen for post-creation additions. Debounce prevents excessive Supabase queries on each keystroke. Participants are stored in the event_participants join table.

CRITICAL story-event-creation-management-coordinator-002 3 pts

Story Points

Critical

Priority

Event Creation & Management

Feature

User Story

As a user

I want to search for contacts by name and select multiple participants to attach to an event using a searchable multi-select widget

So that So that I can quickly find and link all relevant contacts to the event without manually typing individual entries

Acceptance Criteria

Given the participant selection step in the wizard is open, when the user types at least 2 characters in the search field, then matching contacts from their organization appear as selectable items within 500ms of stopping typing
Given search results are displayed, when the user taps a contact, then the contact is added as a chip above the search field and removed from the results list
Given a participant chip is displayed, when the user taps the remove icon on the chip, then the participant is deselected and the contact becomes searchable again
Given the user has selected at least one participant, when they proceed past the participant step, then all selected participants are linked to the event on save
Given no search query is entered, when the participant widget is opened, then an empty state with instructional text is shown rather than loading all contacts
Given a network error occurs during search, when the user types a query, then an error message is shown inline and the user can retry

Business Value

Participant linking is the core differentiator of events versus single-contact activity logs. Fast, searchable participant selection makes it practical to register group sessions with 5–20 participants without frustration. This directly supports HLF and NHF who run large organized group sessions regularly and whose reporting accuracy depends on every participant being counted.

Components

Event Creation & Management

Related Feature

Coordinator

User Role