Embed an events widget on your website

With an events widget you show a list or calendar of several events at once on your own website — for example all upcoming dates of one recurring event. Visitors pick an event and buy tickets without ever leaving your site.

Create a widget

1. In your dashboard, go to Widgets and click New widget.
2. Give the widget a name (only you see this).
3. Choose which events it shows:
   • All upcoming events — everything that is published and in the future.
   • Events from templates — all upcoming events of the templates you pick; new dates appear automatically.
   • Manually selected events — exactly the events you tick.
   • Events at locations — all upcoming events at the chosen locations. You can additionally limit the widget to a date range, and cap the maximum number of events — for example only the next 5 in date order.
4. Pick the view: a compact list or a month calendar. On small screens the calendar automatically falls back to the list.
5. Choose the default language (visitors' dates and labels follow it).
6. Under Ticket page, choose whether the event title and/or date appear above the tickets once a visitor picks an event. This is useful for a calendar, where the day cell only shows a short entry.

Colors and styling

Under Appearance you can override the primary color, background color, and text color, and pick a corner radius. Anything you leave unset inherits your organization branding. Power users can add custom CSS targeting the stable class names shown in the form (.ctx-widget, .ctx-event-card, .ctx-calendar, .ctx-day, .ctx-event-entry).

Put it on your website

After saving, copy the embed snippet and paste it into your website's HTML. Because the snippet only references the widget by ID, you can change the widget's events, view, or styling later without touching your website again.

Shop widgets

With the Shop feature (Studio and Pro) a widget can show your shop instead of events. Under Type, pick Shop and choose what it shows:

• Whole shop — every product for sale, with the category filter buttons above the products when you use categories.
• Chosen categories — tick one or more categories, for example only Merchandise on your merch page.

Each product card shows the image, name, price and availability with two buttons: View opens the product page and Add to cart opens your shop with the product already in the cart. Both open in the same window, where the buyer finishes the order and pays. Sold-out products stay visible with a Sold out badge. A shop widget uses the same Appearance options, default language and embed snippet as an events widget; products you add later show up automatically.

Widgets via the API or a plugin

On the Pro plan every widget action is also available through the REST API: list, create, change and delete widgets, read their embed snippet, and fetch the events a widget shows. That is the foundation for website integrations such as a WordPress plugin that places widgets for you. See API & webhooks.

Good to know

• Only published, upcoming events appear; past events drop out automatically.
• Sold-out events stay visible with a "sold out" badge.
• Ticket checkout happens inside the widget — buyers never leave your site. A shop widget sends buyers to your shop to pay.
• Access codes work in the widget too: buyers can type them in, and an ?unlock= link to the page with your widget unlocks the hidden tickets there.
• For a single event, see the embedded checkout guide.