Tools
Waitlist
Collect email signups with built-in referral tracking. Every signup gets a unique referral link that drives viral growth.
Quick start#
Add a waitlist widget to your page with a single HTML element. The embed script renders a styled signup form automatically.
<!-- Place anywhere on your page --><div data-os-widget="waitlist"></div>How it works#
- Visitor enters their email (and optionally name)
- OperatorStack creates a contact and waitlist signup record
- A unique referral code is generated automatically
- The success state shows the visitor their referral link
- If a
?ref=parameter was present, the signup is attributed to the referrer
Configuration#
Configure the waitlist widget from your project’s dashboard under the Waitlist tab.
| Property | Type | Description |
|---|---|---|
| heading | string | Widget heading text (default: "Join the waitlist") |
| description | string | Subtitle below the heading (default: "Be the first to know when we launch.") |
| buttonText | string | Submit button label (default: "Join") |
| successMessage | string | Message shown after successful signup (default: "You're on the list!") |
| showReferralLink | boolean | Show the referral link in the success state (default: true) |
| confirmationEmail | boolean | Send a confirmation email to new signups (default: false) |
| fields | string[] | Visible fields. "email" is always required. Add "name?" for optional name field. |
SDK usage#
Use the JavaScript SDK to submit waitlist signups programmatically — useful for custom forms or headless integrations.
app.js
const result = await window.OperatorStack.joinWaitlist({ email: 'user@example.com', name: 'Jane Doe' // optional}) console.log(result.referral_code) // "ref_abc123"console.log(result.referral_link) // "https://yoursite.com?ref=ref_abc123"Response#
{ "referral_code": "ref_abc123", "referral_link": "https://yoursite.com?ref=ref_abc123"}Built-in referral tracking#
Every waitlist signup automatically gets a referral code and link. When a referred visitor signs up:
- The embed script detects the
?ref=URL parameter - Stores it in
sessionStoragefor the visit duration - Passes it along when the visitor signs up
- A
referral_conversionevent is tracked - The referrer’s count increments in the leaderboard
Referral link format
Links follow the pattern:
https://yoursite.com?ref=ref_abc123Confirmation email#
When enabled, OperatorStack sends a confirmation email to each new signup with their referral link. Toggle this in the waitlist configuration settings.
API endpoints#
POST
/v1/projects/{projectKey}/waitlist/signupPublicSubmit a new waitlist signup. Returns the referral code and link.
Dashboard features#
- Total signup count and growth over time
- Referral leaderboard — see who’s driving the most signups
- Recent signups list with email, name, referrer, and timestamp
- Widget configuration panel with live preview
- Export signups (coming soon)