Troubleshooting

Most "the widget isn't rendering" issues come down to one of:

1. The placeholder <div data-launchlist-widget> is missing or has the wrong public key. Copy the full snippet again from your dashboard.
2. The script is loading after the placeholder, but blocked by your CSP. Add https://getlaunchlist.com to your script-src and connect-src directives.
3. Your CMS stripped the script tag. Webflow needs an Embed element; WordPress needs a Custom HTML block; Squarespace needs a Code block.
4. An ad blocker is hiding the form. Test in an incognito window.

Still stuck? Open the browser console — the widget logs descriptive errors. Or hit support and we'll diagnose.

Copy link to this answer

A 405 error on submit almost always means the form's action attribute is being rewritten by your CMS or framework. Things to check:

1. Are you using a custom <form> instead of the LaunchList widget snippet? Switch to the widget — the snippet handles the POST internally.
2. Is your hosting provider intercepting POSTs to non-HTTPS endpoints? Make sure your site is HTTPS.
3. Is a router-level rewrite (Next.js, React Router) catching the form submit? The widget submits via fetch, so it should not collide with client-side routing — but if you embedded a raw form HTML, that can.

If you copy-pasted the full LaunchList snippet (script + placeholder div) and still see 405, contact support with the URL.

Copy link to this answer

If the form returns success but the dashboard shows zero signups:

1. Spam protection rejected them. Disposable / blacklisted addresses are silently dropped. Check Settings → Spam protection → Rejected log.
2. You hit your plan cap. Signups continue to be captured but are hidden until you upgrade — see what happens when I hit my limit.
3. The widget is pointing at a different waitlist. Each project has a unique public key — make sure the embedded snippet matches the project you are looking at.
4. Email verification is on and waiting. Submissions appear as "pending" until verified.

If none of these apply, ping support with a sample test email and the project URL.

Copy link to this answer

Two paths:

1. Customize from the dashboard (no code) — under Widget → Customize, change colors, button shape, font, and labels. Most teams match brand in 2 minutes. See Customize widget docs.
2. Override with your own CSS — the widget exposes stable class names like .ll-form, .ll-input, .ll-button, .ll-success. Drop !important overrides if your site's framework wraps them aggressively.

If the widget looks broken specifically (collapsed, overlapping), check that your site's reset CSS is not setting display: none on <form> or <button> elements globally. Tailwind's preflight is fine; aggressive Bootstrap resets occasionally clash.

Copy link to this answer

If admin notifications are not arriving:

1. Check Account → Notifications — make sure new-signup notifications are turned on for the project.
2. Search Spam / Promotions in the inbox — Gmail occasionally aggressive-filters transactional digests.
3. Check the email address on file is correct.

For real-time signal that does not depend on email, set up a Slack notification — most teams switch to Slack-only the moment they hit any meaningful signup volume.

Copy link to this answer

The fix that resolves 90% of these cases is configuring a custom sender domain so welcome emails come from your brand with passing SPF/DKIM/DMARC checks.

Also check:

• Subject line is not all caps or full of !!!.
• Body is not 100% image with no text.
• Plain HTML, not heavy nested tables.
• The reply-to is a real, monitored mailbox.

For a deeper diagnostic, run your domain through mail-tester.com — it'll flag SPF/DKIM/DMARC misalignment in seconds. Full guide: emails going to spam.

Copy link to this answer

The most common reason: the referrer's ?ref=ABC123 parameter is being stripped before the friend lands on the signup page. Check:

1. Did the share link include ?ref=...? The widget appends it automatically — but custom share buttons sometimes don't.
2. Is the friend opening it inside an in-app browser (Instagram, TikTok) that strips query params? Test in a regular browser.
3. Is your site doing a redirect that drops the query string (e.g. trailing-slash rewrite)? Preserve query params on all redirects.
4. Is the friend already on your waitlist? Duplicate signups don't double-count referrals.

If the parameter is intact and the count still doesn't move, share the share link + signup email with support and we'll check the attribution log.

Copy link to this answer

Hosted pages are aggressively cached at the edge for performance, so changes can take a few minutes to roll out globally:

1. Hard-refresh the page (Cmd/Ctrl + Shift + R) to bypass your browser cache.
2. Wait up to 5 minutes for the CDN cache to expire if the change still doesn't appear.
3. Confirm you saved changes in the dashboard — the Save button must turn from green to disabled.
4. If using a custom domain, verify DNS still resolves correctly via dig or whatsmydns.net.

If the page is fully wrong (different brand entirely), you may have copy-pasted the wrong project's slug — double-check Settings → Project info.

Copy link to this answer