WaitlistForm
Collect and manage waitlist signups when using WAITLIST sign-up mode.
Live Demo
Join the Waitlist
Be the first to know when we launch.
Installation
Basic Usage
Props
Prop | Type | Description |
---|---|---|
tenantId | string | Required. The tenant ID |
organizationId | string | Optional. Organization context for multi-org apps |
successMessage | string | Message shown on success |
apiEndpoint | string | Override the API endpoint (default: /api/waitlist) |
customFields | Array<{ name: string; label: string; type?: 'text' | 'email' | 'tel' | 'textarea'; required?: boolean; placeholder?: string; }> | Add additional fields to collect |
appearance.elements | { form?: string; formField?: string; submitButton?: string; } | Customize presentation via classes |
asCard | boolean | Render with a card wrapper (default: true) |
onSuccess | (entry: any) => void | Callback when user joins waitlist (receives entry) |
Customization
Features
✉️ Email Validation
Built-in email format validation
🚫 Duplicate Prevention
Prevents duplicate email entries
🎨 Fully Styled
Ready-to-use design that matches AuthCore
📊 Auto-tracked
Waitlist entries stored in database
API Integration
The WaitlistForm automatically calls /api/tenants/[tenantId]/waitlist
to store entries.
Related
Tips
- Tenant-aware: Pass a
tenantId
when running multi-tenant setups so data is scoped correctly. - Server validation: Re-validate email server-side in your API route before persisting.
- Spam protection: Use rate limits and CAPTCHAs for public-facing waitlist forms.
- Testing: Mock the API and email sender in integration tests to assert success flows.