Most founders spend days wiring up a waitlist. They stitch together a form service, a database, an email tool, and maybe a referral tracker. By the time it works, the launch window has passed.
OperatorStack gives you a waitlist with referral tracking in a single script tag. Here is how to go from zero to collecting signups in under five minutes.
Add one script tag to your landing page. OperatorStack handles the signup form, referral codes, contact storage, and leaderboard. No backend, no database, no third-party integrations.
What You Need Before You Start
You need a landing page (even a single HTML file works) and an OperatorStack account. That is it. No server, no database, no API keys to rotate.
Step-by-Step Setup
Create your OperatorStack account and project. Sign up at OperatorStack, then create a new project. Give it a name and enter your landing page URL. The URL helps OperatorStack configure CORS and analytics tracking for your domain.
Copy your script tag. On the project detail page, you will see your embed snippet. It looks like this:
<script src="https://operatorstack.dev/os.js" data-project="pk_abc123"></script>
The data-project attribute ties everything to your project. Paste this tag into the <head> or just before </body> on your landing page.
Add a waitlist widget to your page. Drop an empty container where you want the signup form to appear:
<div data-os-widget="waitlist"></div>
OperatorStack renders the form inside a Shadow DOM, so it won't conflict with your existing styles. The widget handles the full signup flow: name, email, submission, confirmation, and referral link display.
Customize your widget. Open your project dashboard and navigate to the Waitlist settings tab. From here you can adjust button text, placeholder copy, and success messages. Changes take effect immediately for new page loads (the embed script caches config for five minutes).
Share and track referrals. Every signup generates a unique referral code. After someone joins your waitlist, OperatorStack displays sharing links for Twitter, LinkedIn, Email, and WhatsApp. When a referred visitor signs up, the attribution is automatic. You can view your referral leaderboard in the dashboard.
What Happens Behind the Scenes
When a visitor submits the waitlist form, OperatorStack does three things simultaneously.
First, it creates (or updates) a unified contact record. If that email has already submitted a form or sent a message on your site, the existing contact is reused. No duplicates.
Second, it generates a referral code tied to that contact. The code is shared across all OperatorStack features, so referral attribution works whether the referred person signs up through the waitlist or fills out a different form.
Third, it returns sharing links the visitor can use immediately. The SDK exposes OperatorStack.getShareLinks(referralCode) if you want to build a custom post-signup experience.
Monitoring Your Waitlist
Your project dashboard shows signups in real time. The Waitlist tab gives you the full list with timestamps, referral sources, and position numbers. The Audience tab shows the unified contact list across all channels.
You can also track waitlist performance in the Analytics tab. OperatorStack's cookie-free analytics show you page views, referral sources, and conversion rates (signups divided by unique visitors) without requiring a cookie banner.
Going Beyond the Default Widget
If you prefer a custom signup form, you can skip the widget entirely and use the SDK directly:
const result = await OperatorStack.joinWaitlist({
email: "visitor@example.com",
name: "Jane",
});
const links = OperatorStack.getShareLinks(result.referral_code);
This gives you full control over the UI while OperatorStack handles the backend. All signups still appear in your dashboard, and referral tracking works the same way.
Common Mistakes to Avoid
Forgetting the project URL. If your project URL does not match your landing page domain, CORS will block signups from production. Localhost always works during development.
Over-customizing before launching. The default widget converts well. Ship it, collect real data, then iterate on copy and design.
Ignoring referral data. Your most engaged signups are the ones who share. Check the leaderboard weekly and consider reaching out to top referrers for early feedback.
Frequently Asked Questions
Do I need a backend to run an OperatorStack waitlist?
No. OperatorStack handles signups, referral tracking, and contact management through a single script tag. Your landing page can be pure HTML.
Can I customize the waitlist widget's appearance?
Yes. The widget renders inside a Shadow DOM for CSS isolation, and you can configure colors, button text, and placeholder copy from your project dashboard.
How does referral tracking work?
Every signup receives a unique referral code. When someone shares their link and a new visitor signs up through it, OperatorStack attributes the referral automatically and updates the leaderboard.
Is there a limit on the number of signups?
The free tier includes generous limits for early-stage validation. You can view your current usage from the project dashboard.