FAQ

Troubleshooting

Fix what isn't working

Topic: Troubleshooting

Troubleshooting questions

Why isn't my LaunchList widget showing up on my site?

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

  1. The <div data-launchlist-form="..."> target is missing or has the wrong form ID. Copy the full snippet again from Embed & API → Your website.
  2. The loader script is missing, or blocked by your CSP. The embed.js script tag goes in your <head> once. If your site sets a Content Security Policy, add https://embed.getlaunchlist.com to your script-src, connect-src and font-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. The integration guides cover each platform.
  4. An ad blocker is hiding the form. Test in an incognito window.

For a counter, leaderboard, milestone or countdown widget, the target is data-launchlist-widget with your project handle, and a countdown stays blank until the project has a launch date. Still stuck? Open the browser console: the embed logs its errors there. Or contact support and we'll diagnose.

Why am I getting a 405 Method Not Allowed error on signup?

A 405 error on submit almost always means the signup is being sent with the wrong method or to the wrong address. Things to check:

  1. Are you using a hand-written <form>? Its method must be POST, and its action must be the address copied from Embed & API → Your website. Opening that address in a browser, or sending a GET to it, returns 405.
  2. Is your CMS or framework rewriting the form's action attribute? Check the published page's source and copy the address again.
  3. Is a router-level rewrite (Next.js, React Router) catching the form submit? The embedded form submits via fetch, so it should not collide with client-side routing, but a raw form in your HTML can.

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

Why aren't my signups appearing in the dashboard?

If the form returns success but Audience → Signups shows no new signups:

  1. They are held for review. Spam protection keeps suspicious signups out of your audience until you look at them. A line above the table says how many are held, with a Review button to approve the real ones.
  2. You are past your plan's size. Signups continue to be captured but are hidden until you move up a size: see what happens when I hit my limit.
  3. The form belongs to a different project. Each form has its own ID, so make sure the embedded snippet matches the project you are looking at.
  4. They are test signups. Signups made in test mode stay out of your live audience.

Signups waiting to verify their email are on your list; you can also see them in the Waiting for verification view. If none of these apply, contact support with a sample test email and the project name.

The widget styles don't match my site — how do I fix it?

Two paths:

  1. Style it from LaunchList (no code): the embedded form takes the design, accent color, fonts and corners you pick under Design in the form editor (open Forms and press Edit on the form), the widgets take their colors, font and corner radius from Project settings → Branding, and each widget's background, font and layout are set in the widget editor under Embed & API → Your website. See Customize widget docs.
  2. Keep your own markup and CSS: the embedded form renders in a shadow root, so your site's CSS cannot reach it. To style the form with your own CSS, enhance your own form instead: add data-launchlist-enhance to it, and LaunchList handles the submission while your markup and styles stay yours. See every way to integrate.

Because the embedded form and the widgets are isolated in a shadow root, your site's reset CSS cannot collapse or hide them, and their styles cannot leak into your page.

Why am I not receiving signup notification emails?

LaunchList does not email you about every single signup. You get an email for your first signup, then new signups arrive in a signup digest, once a week by default. If it is not arriving:

  1. Check Account → Notifications: make sure the signup digest is on for email, choose how often it arrives (every day, twice a week or once a week), and check the project is not set to only problems or nothing.
  2. Search Spam / Promotions in the inbox: Gmail occasionally filters digests aggressively.
  3. Check the email address on your account is correct.

Routine emails arrive between 09:00 and 18:00 in your own timezone, so a digest can reach you a day after the period it covers. For a real-time signal for every signup, set up a Slack notification (on the Launch plan and the Grow plan) or a webhook.

Why are my signup confirmation emails landing in users' spam folders?

The biggest single fix is configuring a custom sender domain, on the Launch plan and the Grow plan, so signup 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.

Why is the referral count not updating?

The most common reason: the friend has not verified their email yet. If you ask people to verify, a referral counts when the friend verifies, not when they sign up. Check:

  1. Has the friend verified? Until then the referral waits, and the referrer's status page counts credited referrals only.
  2. Did the share link carry the referral code? The link LaunchList gives each signup does, but custom share buttons sometimes drop the ?ref=... parameter.
  3. Is something dropping the query string? A redirect on your site (e.g. a trailing-slash rewrite) or an in-app browser (Instagram, TikTok) can strip it. Preserve query params on all redirects, and test in a regular browser.
  4. Is the friend already on your waitlist? Duplicate signups don't count as referrals.
  5. Did it fail a fraud check? A referral from the referrer's own device, from an IP address that has already sent too many referrals, or arriving faster than allowed is not credited. Analytics → Referrals shows the blocked referrals and why.

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.

My hosted page is showing the wrong logo or colors. Why?

Check these in order:

  1. Did you publish? Your launch page serves the snapshot from your last publish, so editor changes reach visitors only when you publish again. The Publish button reads Publish changes while your draft differs from the live page.
  2. Did you change it in the right place? Your logo comes from Project settings → Branding. The page's colors and fonts belong to its own theme, set in the page editor.
  3. Hard-refresh the page (Cmd/Ctrl + Shift + R) to bypass your browser cache.
  4. Is it only the link preview? Social networks cache a page's share image for a while after they first fetch it.

If the page is fully wrong (different brand entirely), you may be looking at another project's page: each project's page has its own address, shown in the editor's publish panel.

My signups aren't getting the verification or welcome email (or it's slow)

LaunchList sends signup emails through a background queue, so there's normally a short delay (seconds to a couple of minutes). If your signups aren't getting their verification or welcome email, work through these:

  1. Is the email actually turned on? A verification email only goes out from a form with Ask people to verify their email on (open the form in Forms, then Settings). The welcome email can be switched off in Emails → Library, and for someone who has not verified yet, it waits until they do.
  2. Check spam / Promotions. Transactional emails sometimes land there. On the Launch plan and the Grow plan, sending from your own domain is the single biggest deliverability fix: see custom sender domain and why emails go to spam.
  3. The address may not take mail. An undeliverable or disposable address is skipped, and an address that bounced or reported spam gets no more email. Some providers (Yahoo, iCloud, regional domains) are stricter than others, and if several people at one company are missing it, their mail filter is usually holding it.
  4. Resend it. Each signup's status page has a resend button for the verification email, and you can select people in Audience and choose Resend verification.
  5. During a big launch spike? Very large bursts of signups in a short window can lag the email queue. It catches up on its own, but if a lot of people report missing emails during a live launch, contact support with your project name and we'll check the send logs.

If a specific address still gets nothing after all of the above, send us that email and the project name and we'll trace it in the delivery log.

Signups fail when people come from an Instagram, Facebook, or TikTok link

This is one of the most common "it works for me but not my visitors" issues, and it's almost always the in-app browser. When someone taps your link inside Instagram, Facebook, TikTok, or LinkedIn, it opens in a stripped-down browser that can't open new tabs and often drops URL parameters. That breaks two things: a form set to open its result in a new tab silently fails, and the ?ref= referral code gets lost.

How to fix it

  1. Keep the result in the same tab. A form opens the status page or your Link in the same tab, which works inside in-app browsers. A form set up earlier to open its result in a new tab keeps doing so, and the form editor has no setting to change it: choose Message under After signup and publish, so signups see your message where the form was, or ask support to switch the new tab off for you. If you hand-built a form that does target="_blank", that's what's failing.
  2. For link-in-bio traffic, send people straight to your hosted waitlist page instead of a deep link into another page, so the form is the first thing they see.
  3. Don't rely on a new-tab "thank you" page. Keep the confirmation in the same tab (the form does this by default).
  4. Test it the way your visitors arrive. Post the link in an Instagram story/DM to yourself and tap it from the app; don't only test in desktop Chrome.

If referral counts specifically aren't moving, also check why the referral count isn't updating. If you've done all this and signups from a specific app still fail, send support the exact link you're sharing and the app you're testing from.

Still stuck?

The setup guides go step by step. If they don't help, write to us.

Your waitlist can be live today

Pick a starting page, put it in your own words and share the link. Everyone who joins gets a place in line and a link to bring their friends.

Free to startNo credit card needed