Quick Start for Attendees¶
Overview¶
This guide helps guests and registered attendees find events, RSVP or purchase tickets, manage their profile, and prepare for event day—including QR tickets, networking, and privacy controls.
Purpose¶
Get participants from sign-up to checked-in attendee in the fewest steps, with clear paths for both RSVP (simple headcount) and Registration (ticketed, Attendees module) events.
Who should use it¶
| Persona | Scenario |
|---|---|
| Guest | Invited to a private RSVP event via link |
| Registered user | Browsing Discover or registering for a conference |
| Ticket holder | Paid or free registration with QR check-in |
| Mobile user | Using the Nigall mobile API companion experience |
Benefits¶
- Understand RSVP vs full registration before you start
- Access tickets, agenda, and networking from one account
- Know where to manage privacy and data requests
Prerequisites¶
- Modern web browser (or Nigall mobile client)
- Email address for account creation (recommended)
- Event URL from organizer:
/events/<id>/<event_tag>/ - For paid events: payment method accepted by Stripe checkout
Navigation path¶
| Action | Path |
|---|---|
| Browse public events | /events/discover/ |
| Event detail | /events/<pk>/<event_tag>/ |
| RSVP (RSVP events) | /events/<pk>/<event_tag>/rsvp/ |
| Guest RSVP (no account) | /events/<pk>/<event_tag>/guest-rsvp/ |
| Attendee registration | /attendees/register/<pk>/<event_tag>/ |
| My registrations | /attendees/ |
| Attendee profile | /attendees/profile/ |
| Privacy center | /attendees/privacy/ |
| Ticket / QR | /attendees/registrations/<pk>/ticket/ |
| Sign in | /accounts/login/ |
| Sign up | /accounts/signup/ |
Step-by-step — RSVP event (beginner)¶
1. Open the event link¶
Your host shares a URL like /events/42/GKKILK/. Public events may also appear on Discover (/events/discover/).
[SCREENSHOT: Event detail page — guest view]
2. Sign in or RSVP as guest¶
- Signed in: Use the RSVP sidebar on the event page.
- No account: Use Guest RSVP if the event allows it (
/events/<pk>/<tag>/guest-rsvp/).
3. Complete RSVP form¶
| Field | Description |
|---|---|
| Status | Will Attend, Regrets, Tentative |
| Adults / Kids | Party size (counts toward capacity) |
| Survey questions | Host-defined custom fields |
| Message to host | Optional note |
4. Save confirmation¶
You receive on-screen confirmation. Logged-in users can update RSVP later from the same event page.
5. Event day¶
Hosts check you in from their guest list. You do not need a QR code for basic RSVP events unless the host enables attendee-style check-in separately.
Step-by-step — Ticketed / Registration event (intermediate)¶
1. Open event → Get tickets or Register¶
When Attendee Management is enabled, you are routed to /attendees/register/<pk>/<event_tag>/.
2. Complete registration profile¶
Fill required fields (name, email, tier selection, custom questions).
3. Pay (if applicable)¶
Navigation: /attendees/registrations/<pk>/payment/ → Stripe checkout via /attendees/registrations/<pk>/pay/
4. View ticket¶
Navigation: /attendees/registrations/<pk>/ticket/
Download QR, print, or resend email.
5. Check in¶
Staff scan your QR at /attendees/events/<pk>/<tag>/checkin/scan/.
Field descriptions¶
RSVP fields (guest)¶
| Field | Required | Notes |
|---|---|---|
| Status | Yes | attending, regrets, tentative, waitlist, cancelled |
| Adult count | Default 1 | Counts toward capacity |
| Kid count | Default 0 | Counts toward capacity |
| Guest name / email | Guest flow | Required for guest-link RSVPs |
| Survey answers | Per question | Prefix cq_<id> in form |
Registration fields (Attendees module)¶
See Attendee Management and Participant Guide.
Business rules¶
| Rule | Detail |
|---|---|
| RSVP capacity | adult_count + kid_count for status=attending |
| Waitlist | Auto-assigned when capacity full on new attending RSVPs |
| One RSVP per user per event | unique_together on event + user |
| Host view | Event host sees management UI, not guest RSVP form |
| Past events | RSVP and registration disabled after end_date |
| Private events | Link-only; not on Discover |
Validation rules¶
- End date must be in the future to RSVP/register
- Required survey questions block submit
- Paid tiers require successful Stripe payment before confirmation
User permissions¶
| Action | Guest (anon) | Participant | Host |
|---|---|---|---|
| View public event | ✅ | ✅ | ✅ |
| RSVP (free RSVP) | ✅ guest flow | ✅ | Preview as other account |
| Register (Attendees) | ❌ usually | ✅ | Preview as other account |
| View own ticket | ❌ | ✅ | N/A |
| Guest list | ❌ | ❌ | ✅ |
Workflow¶
Examples¶
Wedding guest: Private RSVP link, meal choice survey, no account needed (guest RSVP).
Conference attendee: Public Discover listing, paid tier, QR ticket, session registration via Program module.
Best practices¶
- Create an account to manage all events in one place
- Save ticket QR offline before event day
- Complete networking privacy settings before enabling directory visibility
- Use a personal email you can access on event day
Tips¶
- Guest RSVP link with token:
/events/<pk>/<tag>/guest-rsvp/<token>/— bookmark to update without signing in - My Events on mobile API:
GET /api/mobile/v1/tickets/ - Revisit event page to update survey answers after RSVP
Common mistakes¶
| Mistake | Result | Fix |
|---|---|---|
| Testing as event host | No RSVP form | Use incognito or test account |
| Ignoring waitlist email | Miss promotion window | Watch inbox; respond promptly |
| Wrong email on guest RSVP | Cannot recover link | Contact host |
FAQs¶
Do I need an account to RSVP?
Many RSVP events support guest RSVP. Registration events typically require an account.
Where is my ticket?
/attendees/registrations/<registration_id>/ticket/ after logging in.
Can I transfer my ticket?
Depends on organizer settings; contact the host.
Troubleshooting¶
| Symptom | Cause | Fix |
|---|---|---|
| No RSVP button | Past event / full / host view | Check dates; use guest account |
| Payment stuck | Stripe session expired | Retry from registration payment page |
| QR won't scan | Brightness / damaged image | Use ticket resend; manual check-in |
| Not on Discover | Private event | Use direct link from host |
Related features¶
Screenshot placeholders¶
[SCREENSHOT: Discover page with event cards][SCREENSHOT: RSVP sidebar with survey questions][SCREENSHOT: Ticket page with QR code][SCREENSHOT: Attendee dashboard with registrations list]
Administrator notes¶
Ensure email delivery (Resend/SES) is configured so confirmation and ticket emails reach attendees.
Developer/API notes¶
| Endpoint | Method | Notes |
|---|---|---|
/api/mobile/v1/events/discover/ |
GET | JWT — public events |
/api/mobile/v1/events/<pk>/<tag>/ |
GET | Event detail |
/api/mobile/v1/events/<pk>/<tag>/rsvp/ |
POST | RSVP events only; survey not yet on mobile |
/api/mobile/v1/tickets/ |
GET | User's tickets |
Next: Participant Guide · Account Setup