Direct Iframe Embed

When to Use the Direct Iframe

Use the Direct Iframe method when:

• You need full control over the iframe size
• Your website builder doesn't support JavaScript
• You're building a custom integration
• You prefer a plain iframe without the auto-resize script

For most websites, the Embed Script (recommended method) is easier and works better. The Direct Iframe is primarily for developers and custom setups.

How It Works

The Direct Iframe snippet is a standard HTML <iframe> tag pointing to your event on Equaticket:

<iframe
  src="https://equaticket.com/embed/[your-org-slug]/[your-event-slug]"
  width="100%"
  height="600"
  frameborder="0"
  style="border: none; border-radius: 8px;"
  title="Event Tickets"
></iframe>

The src URL contains a signed authentication token that expires after 30 days. After expiration, the iframe will show a blank or error state.

Setting a Fixed Height

Unlike the Embed Script, the Direct Iframe does not automatically resize. You must set a fixed height attribute to accommodate your ticket list.

As a starting point, use these heights:

• 1–2 ticket types: 400px
• 3–4 ticket types: 550px
• 5+ ticket types: 700px

If you see content cut off or a scrollbar, increase the height by 50–100px increments until it fits.

The width: 100% is recommended — this makes the iframe fill its container on any screen size.

The Token Expires

The event_token in the iframe URL is valid for 30 days. If you embed on a page that stays live for months, you'll need to refresh the token periodically:

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

You'll see a fresh event_token in the new URL. This resets the 30-day expiry counter.

Content Security Policy

If your website uses a Content Security Policy (CSP) header, add this directive to allow the iframe:

frame-src https://equaticket.com;

Most websites don't use CSP — you only need this if your site explicitly sets a CSP header.

Frequently Asked Questions

Why is my iframe blank?

The most common cause is an expired token. Go to your dashboard, copy a fresh Direct Iframe snippet, and re-paste it.

If the token is fresh and it's still blank, check:

• Is your event published? (Draft events don't render in embeds)
• Does your site have a Content Security Policy? Check your browser's Console (press F12) for CSP errors
• Are you on a restricted network that blocks third-party iframes?

Can I change the width?

Yes. The default is width="100%" which fills its container. You can set a fixed pixel width like width="600" if needed.

Can I remove the scrollbar?

The scrollbar appears when the content doesn't fit the height. Increase the height attribute until the content fits.

Can I style the iframe border?

Yes. The style="border: none; border-radius: 8px;" example shows how to set border and corner radius. You can modify this to match your site's design.

What if I can't change the token?

If you're on a website builder that doesn't let you edit code easily, try the Embed Script method instead — it doesn't require token management. Or use the Modal Button method if you only want a clickable button on your page.

Still need help? Contact support.