Usetix
Browse guides

Ticket and event-directory embeds

Usetix offers two iframe embeds for your own website:

  • The ticket box puts ticket selection for one event on a page.
  • The event directory keeps a complete grid of upcoming events up to date automatically.

Both lead into the normal hosted Usetix shop and checkout.

Use this when your event already has a full website, festival page, venue page, or campaign landing page and you only want Usetix to handle ticket selection, checkout, payment, invoices, ticket delivery, and check-in.

Embed one event’s ticket box

How it works

Each event has an embed URL:

https://your-shop-domain/events/spring-showcase/embed

The embed is built for an iframe. It shows the event name, date, venue, available tickets, quantity controls, cart total, and a checkout button.

When the buyer clicks checkout, Usetix opens the hosted checkout as a top-level page. Checkout is not completed inside the iframe. That keeps payment redirects, legal consent, invoice fields, custom checkout questions, promo codes, stock reservation, and ticket delivery inside the normal Usetix flow.

Add the iframe

Open the event in Usetix, open the event actions menu, and choose Embed ticket box. Usetix shows the iframe snippet, the normal hosted event link, and preview links for the embed.

The iframe snippet looks like this:

<iframe
  src="https://your-shop-domain/events/spring-showcase/embed?ref=embed"
  title="Tickets for Spring Showcase"
  style="width:100%; min-height:420px; border:0;"
  loading="lazy">
</iframe>

Paste it into the page where tickets should appear. The iframe is intentionally simple: no floating widget script, no auto-resize script, no extra tracking script. Start with at least 420px height and adjust if your ticket list needs more room.

If your website builder does not allow iframes, use the hosted event link shown on the same embed page.

Private and hidden tickets

Hidden tickets keep working through access codes. If your event has hidden ticket types, the embed setup page shows separate snippets for those tickets.

A private-ticket embed URL includes code:

https://your-shop-domain/events/spring-showcase/embed?ref=embed&code=vip

Only people who load the embed with the right code see that hidden ticket. The same code is carried into checkout.

Preview and unpublished events

Published events can be embedded right away. Draft or unpublished events use the same preview protection as the normal Usetix shop, so you can test the embed before making the event public.

When the event is live, share or embed the public URL without the preview token.

Embed your upcoming event directory

Open Settings → Shop and find Embed event directory. Usetix provides a snippet like this:

<iframe
  src="https://your-shop-domain/events/embed?ref=embed"
  title="Upcoming events from Your Organization"
  style="width:100%; min-height:640px; border:0;"
  loading="lazy">
</iframe>

The directory contains upcoming events that are both published and listed. Drafts, past events, and intentionally unlisted events do not appear. The grid follows your shop theme and account branding. Clicking an event opens its public Usetix page as the top-level browser page, outside the iframe.

The list updates automatically when you publish, unpublish, list, unlist, or reschedule an event. Start with at least 640px height; a larger lineup may need more space because the embed deliberately has no cross-site auto-resize script.

The Shop settings API returns the ready-to-use URL as event_directory_embed_url. If you need full control of the surrounding markup or a native card design, use the public events JSON feed instead.

Attribution and promo codes

Ticket-box and event-directory URLs can carry the same campaign parameters as normal shop links:

Parameter What Usetix keeps
utm_source Platform or partner, such as instagram, newsletter, or venue-site.
utm_medium Channel, such as social, email, or affiliate.
utm_campaign Campaign name.
utm_term Paid-search keyword, if relevant.
utm_content Creative or placement variant.
ref Free-form referral code. Embed snippets default to ref=embed.
promo Promo code to prefill/apply in checkout when valid. Most useful for a single-event ticket box.

Those values are passed from the iframe into checkout and saved on the order. You can see attribution in the order detail and in webhook payloads. For the broader attribution model, see UTM tracking.

What the embeds do not do

  • They do not replace your Usetix checkout.
  • They do not process card, wallet, PayPal, or local payments inside the iframe.
  • They do not expose a custom checkout API.
  • They do not include a floating launcher or auto-resizing script.

This keeps the integration small and robust: your website owns the event storytelling, Usetix owns the buying flow.

Need help embedding an event? Contact support.