Frequently Asked Questions (FAQ)
Quick answers to common questions about Waitlist Widget. ❓
Table of Contents
General
What is Waitlist Widget?
Waitlist Widget is a developer-first tool to add waitlist functionality to your product in minutes. Simply embed our widget or use our API to start collecting email signups.
Who is this for?
- Indie developers building MVPs and launching new products
- Startups validating product ideas before full development
- SaaS companies managing beta access and feature launches
- Product managers coordinating phased rollouts
How quickly can I get started?
Most users have a working waitlist embedded in under 5 minutes. Just create a project, copy the embed code, and paste it into your HTML.
Do I need technical knowledge?
No coding required for basic usage - just copy-paste the widget code. However, developers can use our REST API for advanced integrations.
What's the difference from Mailchimp/ConvertKit?
We're simpler and cheaper for waitlist-specific use cases:
- No complex email campaigns (we focus on waitlists)
- Clean, developer-friendly API
- Affordable pricing ($9/mo vs $20-50/mo)
- Instant setup (no onboarding steps)
Pricing & Billing
Is there a free plan?
Yes! The free plan includes:
- 1 project
- 100 subscribers
- Basic dashboard
- CSV export
Perfect for testing or small launches.
What happens if I exceed my plan limits?
Graceful handling:
- Free plan: Widget stops accepting new signups after 100 subscribers
- Paid plans: We'll notify you before hitting limits
- Overage: Upgrade anytime - no data loss
You can always export your data before upgrading.
Can I upgrade/downgrade anytime?
Yes, anytime!
- Upgrade: Instant access to new features
- Downgrade: Takes effect at end of billing period
- No penalties for plan changes
What payment methods do you accept?
We accept:
- 💳 Credit cards (Visa, Mastercard, Amex, Discover)
- 💵 Debit cards
- 🌍 International cards
Payments processed securely via Lemon Squeezy.
Do you offer refunds?
Yes, we offer a 30-day money-back guarantee for first-time subscribers. If you're not satisfied within the first 30 days, we'll refund you in full.
After 30 days, refunds are evaluated case-by-case (service downtime, billing errors, etc.).
Can I get an invoice?
Yes! Invoices are automatically generated and emailed after each payment. You can also download them from your dashboard:
Dashboard → Billing → Invoice History
What happens if payment fails?
We'll:
- Retry your card automatically (3 attempts over 7 days)
- Email you to update payment method
- Downgrade to Free plan after 7 days if unresolved
Your data remains safe - just update your card to restore access.
Can I cancel anytime?
Absolutely! Cancel anytime from your dashboard with one click. No contracts, no commitments.
Dashboard → Billing → Cancel Subscription
After cancellation:
- Access continues until end of billing period
- Automatically downgraded to Free plan
- All data remains accessible (export anytime)
Technical
What platforms are supported?
Universal compatibility:
- ✅ HTML/CSS/JavaScript (any static site)
- ✅ React
- ✅ Next.js (App Router & Pages Router)
- ✅ Vue.js
- ✅ WordPress (custom code)
- ✅ Webflow (custom code embed)
- ✅ Any platform that supports JavaScript
Is CORS an issue?
No! Our widget works cross-origin. The public subscribe endpoint allows all origins by default.
For API requests (dashboard), use your API key with proper authentication headers.
Can I customize the widget appearance?
Yes, fully customizable!
- Use our configuration options (colors, text, theme)
- Override with custom CSS (full control)
- Build your own form using our API
See: Widget Customization Guide
Does it work on mobile?
Yes! The widget is fully responsive and mobile-friendly:
- ✅ iOS Safari
- ✅ Chrome Android
- ✅ Mobile browsers worldwide
What about performance?
Optimized for speed:
- Widget script: < 5KB gzipped
- Load time: < 500ms
- No jQuery or heavy dependencies
- Lazy loading support
Can I use the API without the widget?
Absolutely! Use our REST API to:
- Build custom forms
- Integrate with backend systems
- Automate subscriber management
- Create custom workflows
See: API Documentation
Does it support multiple domains?
Yes! One project can receive signups from:
- Multiple domains
- Multiple pages
- Multiple embeds
Track source with metadata (coming soon in Pro plan).
Security & Privacy
Is Waitlist Widget GDPR compliant?
Yes! We're GDPR-compliant:
- Users can request data deletion
- We don't sell user data
- Clear privacy policy
- Data processed in EU-friendly regions
How is my data stored?
Securely:
- Encrypted at rest (AES-256)
- Encrypted in transit (TLS 1.3)
- Hosted on Vercel (SOC 2 compliant)
- Database on Supabase (SOC 2 + ISO 27001)
Do you use cookies?
Minimal cookies:
- Authentication cookie (logged-in users only)
- No tracking cookies on public widget
- Analytics via Umami (privacy-focused, cookie-free)
Can users unsubscribe?
Yes! Users can unsubscribe via:
- Request via email (support@waitlistwidget.com)
- You can remove them from dashboard
- Webhook integration for automated unsubscribe
What happens to my data if I cancel?
Your data is safe:
- Data remains accessible for 90 days after cancellation
- Export anytime as CSV
- After 90 days, data is permanently deleted (GDPR compliance)
Are API keys secure?
Yes!
- Keys use strong random generation
- Never logged in plaintext
- Rotate keys anytime from dashboard
- Separate keys for test/production (coming soon)
Do you comply with CCPA?
Yes! We comply with CCPA (California Consumer Privacy Act):
- Users can request data deletion
- No sale of personal information
- Transparent data practices
Features
Can I export my subscribers?
Yes! Export anytime as CSV:
Dashboard → Project → Export CSV
Includes: email, subscribed date, metadata (if available).
Do you offer webhooks?
Yes! (Starter & Pro plans)
Webhooks notify your server in real-time when:
- New subscriber joins
- Subscriber removed
- Project updated
See: Webhook Guide
Can I send emails to subscribers?
Not directly. We focus on collection, not email campaigns.
Recommended workflow:
- Collect emails with Waitlist Widget
- Export CSV
- Import to email tool (Mailchimp, ConvertKit, Resend, etc.)
Or use webhooks to trigger emails automatically!
Can I have multiple projects?
Yes!
- Free plan: 1 project
- Starter plan: 5 projects
- Pro plan: Unlimited projects
Perfect for multiple products or A/B testing different landing pages.
Is there a subscriber limit?
Per-project limits:
- Free: 100 subscribers
- Starter: 5,000 subscribers
- Pro: Unlimited subscribers
Need more? Contact us for enterprise plans.
Can I import existing subscribers?
Coming soon! (Roadmap: Q1 2026)
For now, subscribers must join via:
- Widget form
- Direct API calls
Do you support custom domains?
Not yet. Widget loads from waitlistwidget.com.
However, you can fully customize styling to match your brand.
Custom domains are on our roadmap (Pro plan feature).
Can I track analytics?
Yes! Dashboard shows:
- Total subscribers
- Signups over time (chart)
- Growth rate
- Export history
Advanced analytics (Pro plan) includes:
- Referrer tracking
- Device/browser stats
- Conversion rates
Do you have an affiliate program?
Not yet, but it's coming soon!
Want to be an early affiliate? Email us
Support
How can I get help?
We're here for you!
- 📧 Email: support@waitlistwidget.com - We typically respond within 24 hours
- 📚 Documentation: QUICKSTART.md, API.md, WIDGET.md, WEBHOOKS.md
What's your response time?
Support response times:
- Free plan: 48-72 hours
- Starter plan: 24-48 hours
- Pro plan: 12-24 hours
- Critical issues: < 6 hours (all plans)
Do you offer custom development?
Yes! For Pro plan users, we offer:
- Custom integrations
- White-label solutions
- Dedicated support
- Feature prioritization
Contact us for pricing.
Is the code open source?
No, Waitlist Widget is currently closed-source. However, we:
- Share integration examples and best practices
- Provide comprehensive documentation
- Welcome feature suggestions and feedback
- May open-source components in the future
Can I request features?
Absolutely! We love feedback.
Submit feature requests:
- Email us at support@waitlistwidget.com with your ideas
- We typically respond within 24-48 hours
- Popular requests get prioritized in our roadmap
Where can I report bugs?
Bug reports:
- Email: support@waitlistwidget.com
Please include:
- Steps to reproduce
- Expected vs actual behavior
- Browser/device info
- Screenshots (if applicable)
We aim to respond within 24 hours and fix critical bugs immediately.
Do you have a status page?
Coming soon! For now, email support@waitlistwidget.com to check system status or report outages.
Still have questions?
Can't find your answer?
- 📧 Email us: support@waitlistwidget.com
- 📚 Read docs: QUICKSTART.md, API.md, WIDGET.md, WEBHOOKS.md
We typically respond within 24 hours and love helping our users succeed! 💙