Embed Troubleshooting

Widget Is Blank or Not Showing

Check 1: Is Your Event Published?

Embeds only work with published events. If your event is in draft, paused, or cancelled status, the widget will show nothing or a fallback message.

1. Go to your Equaticket dashboard
2. Check your event's status
3. If it's not published, click Publish and confirm

Check 2: Is the Token Expired? (Direct Iframe Only)

If you're using the Direct Iframe method, the authentication token in the URL expires after 30 days.

1. Go to your event in the dashboard
2. Click Share & Embed
3. Copy a fresh Direct Iframe snippet
4. Replace the old code on your website

Check 3: Content Security Policy

If your site has a Content Security Policy (CSP) header, it may be blocking the iframe or scripts.

1. Open your browser and press F12 (Developer Tools)
2. Click the Console tab
3. Look for errors mentioning "Content Security Policy" or "frame-src"
4. If you see CSP errors, add these directives to your site's CSP:

frame-src https://equaticket.com;
script-src https://equaticket.com;
connect-src https://equaticket.com;

If you don't manage your site's CSP, ask your web hosting provider or developer to add these directives.

Check 4: Ad Blockers

Some ad blockers block iframe embeds or scripts from third-party domains. This usually only affects you (the site owner with an ad blocker) — regular visitors without the blocker can see the widget fine.

Test in an incognito or private browser window with all extensions disabled. If the widget works in incognito, an ad blocker is the culprit.

Check 5: Squarespace Preview Mode

Squarespace does not render Code Blocks while you're editing. You'll see a blank space in the editor. This is normal.

To verify the widget is working:

1. Click Publish in Squarespace
2. Open the published page in an incognito browser window (not logged into Squarespace)
3. The widget should now be visible

Do not test in the Squarespace editor preview. Always test the published live page.

Widget Appears but Checkout Won't Open

This is usually a pop-up blocker. Stripe opens in a new browser tab. If the visitor's browser blocks pop-ups for your site, the payment tab won't open.

Most browsers show a notification bar saying "Pop-up blocked" when this happens. Ask visitors to click the notification and allow pop-ups for your site.

This is a browser setting, not an Equaticket issue. Visitors can allow pop-ups in their browser preferences if they choose to.

Widget Is Cut Off or Has a Scrollbar

This happens with the Direct Iframe method (the Embed Script auto-resizes, so this shouldn't happen with that method).

Solution: Increase the height value in the iframe's style attribute.

Try 600px first:

<iframe
  src="https://equaticket.com/embed/..."
  height="600"
  ...
></iframe>

If content is still cut off, increase by 50–100px increments until it fits without scrolling.

Modal Button Does Nothing When Clicked

1. Open your browser Developer Tools (press F12)
2. Go to the Console tab
3. Click the button
4. Look for any red error messages
5. Check these things:

- Is the eq-widget.js script tag in your page? (Right-click page → View Page Source, search for eq-widget.js)

- Is the data-eq-event-id attribute on the button correct? (Must exactly match your event ID with no extra spaces)

- Is your event published?

Most common cause: An ad blocker or extension blocking the eq-widget.js script. Test in an incognito window with extensions disabled.

Widget Works for Me but Not for Visitors

If the embed works when you test it but visitors report problems:

1. Check for ad blockers — you might be using one that your visitors don't have
2. Check for network restrictions — you might be on a corporate VPN or school network that blocks third-party iframes, while visitors on regular home internet are fine
3. Ask visitors to describe what they see — blank, loading spinner, error message? — and check the relevant section in this guide
4. Ask visitors to test in incognito mode — this often rules out ad blockers and extensions

Ticket Quantities Aren't Updating

The embed fetches fresh data on each page load. If you're seeing old ticket quantities:

Try a hard refresh to clear your browser cache:

• Mac: Cmd + Shift + R
• Windows: Ctrl + Shift + R

Visitor-facing pages are not cached long-term, so fresh visitors will see current quantities automatically.

Widget Shows on Desktop But Not Mobile

Check your website builder's mobile visibility settings. Some builders let you hide sections on mobile.

1. Check if your Code Block / Embed / widget is hidden on mobile
2. If using Shopify, check the section's mobile visibility toggle
3. If using Wix, check the element's mobile display settings

I'm Getting a "Blank Page" Error

This usually means:

1. Your event URL slug or org slug is wrong in the embed code
2. Your event doesn't exist or was deleted
3. Your event is not published

Double-check the embed code snippet in your dashboard. If the event no longer exists, create a new event and get a fresh embed code.

Content Security Policy Reference

If your developer needs the full CSP directives, add these to your site's CSP header:

frame-src https://equaticket.com;
script-src https://equaticket.com;
connect-src https://equaticket.com;
img-src https://equaticket.com https://assets.equaticket.com;

The img-src line is needed if you've added custom branding images. The first three lines are the minimum for basic embeds.

Still need help? Contact support.