Glossary, FAQ & Troubleshooting¶

Overview¶

Central reference for Nigall terminology, cross-cutting FAQs, and symptom-based troubleshooting across RSVP, registration, modules, billing, and APIs.

Purpose¶

Reduce support ticket volume with searchable definitions and fix paths.

Who should use it¶

All users — organizers, attendees, admins
Support staff
New team members onboarding

Benefits¶

Consistent vocabulary
Quick answers without opening multiple articles
Master troubleshooting index

Glossary¶

Term	Definition
Event tag	6-character uppercase slug in URLs (e.g., `GKKILK`)
Host	`Event.host` user with full management rights
RSVP	Lightweight registration type with guest list
Registration	Full registration type; often uses Attendees module
Attendees module	`attendees_enabled` — tickets, QR, GDPR, networking
Discover	Public catalog at `/events/discover/`
Tools hub	`/events/tools/` — subscription-gated module entry
Module toggle	Boolean on Event enabling feature set
Setup wizard	Post-save configuration steps per enabled module
Platform fee	Nigall % on ticket revenue (5% or 3%)
Essentials	Paid plan `basic` — core tools
Presenter Pro	Plan `plus` — speakers, talent, venues
Operations Suite	Plan `pro` — volunteers, vendors, sponsors
Planner Pro	Plan `planner_pro` — Operations Suite + Event Planner CRM ($49/mo)
Event Planner CRM	Client pipeline, contacts, partnerships at `/planner/`; see guide
Client viewer	User on `Event.client_viewers` with read-only event access
Enterprise	Sales tier for Exhibitors module
Prospectus	Marketing copy for exhibitor/vendor/sponsor applicants
Social Sharing Kit	Host tool generating hashtags/captions for social platforms; see Social Sharing
Waitlist	Queue when capacity full
access_token	UUID for guest RSVP link updates
Account (talent)	Org UUID for Talent CRM API scoping
approval_type	auto / organizer / admin for applications

FAQs¶

General¶

What is Nigall?
Enterprise event management SaaS — events, attendees, payments, communications, and modular expo/sponsor/speaker operations.

Do I need a paid plan to create events?
No. Free accounts create events; paid plans unlock Tools modules.

What's the URL format?
/events/<numeric_id>/<event_tag>/ — both required.

RSVP vs Registration¶

When should I use RSVP?
Invite-only gatherings, weddings, internal meetings — simple headcount + survey.

When should I use Registration?
Conferences needing tickets, QR, exports, GDPR, networking.

Can I use both on one event?
No — single registration_type per event. Attendees module replaces RSVP sidebar for registration type.

Billing¶

What are transaction fees?
5% on Free/Essentials ticket revenue; 3% on Presenter Pro, Operations Suite, and Planner Pro.

What is Planner Pro?
A $49/mo plan for professional event planners: includes Operations Suite tools plus Event Planner CRM (clients, pipeline, contacts, client viewer access).

How do I upgrade?
/pricing/ → select plan → Stripe checkout.

Modules¶

Why is Exhibitors locked?
Enterprise-only — contact sales.

Are judges supported for speakers?
No — not implemented; roadmap item.

Does SMS work?
Flag exists (sms_reminders_enabled); email is primary. SMS requires provider config.

Marketing¶

How do I get social media captions for my event?
Open event detail as host → Social sharing kit → Generate. See Social Sharing & Hashtag Generator.

Does Nigall post to Instagram for me?
No — the kit provides copy to paste or schedule externally.

Attendees¶

Where is my ticket?
/attendees/registrations/<id>/ticket/ when logged in.

Can I RSVP without an account?
Guest RSVP when host allows /guest-rsvp/.

Mobile¶

Is there a native app API?
Yes — /api/mobile/v1/ for discover, RSVP, tickets. Full registration is web.

Troubleshooting master table¶

Symptom	Likely cause	Resolution
404 on event URL	Wrong or missing event_tag	Copy URL from View Event
No RSVP form visible	Logged in as host	Incognito / test account
Module menu missing	Plan or toggle	Upgrade; enable on event
Event not on Discover	Private or no category	Public + category
Can't save public event	Missing category	Add event_category
Module toggle grayed	Subscription too low	Upgrade plan
Wizard skipped	No modules enabled	Enable toggle; save
Paid but no ticket	Webhook failure	Replay Stripe webhook
QR scan fails	Wrong event URL	Match pk/tag
Survey not on form	is_active=False	Visible to guests
Tools empty	Free plan	Subscribe Essentials+
Exhibitors won't enable	Not Enterprise	Contact sales
SMS not sent	No SMS_PROVIDER	Configure or use email
Mobile RSVP fails	Registration-type event	Use web register
Co-host can't edit	Not implemented	Use host account
Guest list empty	No RSVPs	Share link
Registration 404	attendees_enabled off	Enable module
Coupon ignored	Typo in code	Match coupon_code exactly
Recurrence wrong dates	Edit scope	Use series edit carefully
JWT 401 mobile	Expired token	Re-login
Talent API 404	Wrong account UUID	List accounts endpoint
Email not delivered	ESP config	Check Resend/SES
High platform fee	On Essentials	Upgrade to 3% tier

Business rules (quick reference)¶

Area	Rule
Capacity	RSVP: party size sum for attending
Waitlist	Auto when full
Public	Requires category
Fees	Plan-based 5% or 3%
Host	Single user per event
Staff	Bypass plan gates

Validation rules (quick reference)¶

End date after start date
Public requires category
Required survey questions block submit
Positive capacity and party counts

User permissions (quick reference)¶

See Roles & Permissions.

Workflow¶

N/A — reference document.

Examples¶

N/A — see feature articles.

Best practices¶

Bookmark this page for support triage
Search symptom column first
Cross-link to detailed articles from Related features

Tips¶

Use /events/lookup/ for event search
Check reference/known-limitations.md for roadmap gaps

Common mistakes¶

Relying on this page instead of feature-specific guides for setup steps — use both.

Screenshot placeholders¶