Two lines on any page
The widget is one self-contained script — no framework, no build step, no external
dependencies. It reads the API address from its own src, so the same snippet works in
every environment. Fill in the options below and the snippet updates as you type.
The publishable key is safe in a browser: it can only list your
published events and submit registrations. Never put a secret key
(sk_…) in a web page.
Options
Every attribute is optional except data-key. Defaults are left out of the
snippet, so what you copy is only what you actually changed.
full, whatever you set here.zh-Hant. Leave empty so each visitor sees their own.Live preview
Renders the snippet above in an isolated frame, against your real published events. It always starts fresh, so you see the layout your attributes ask for — a returning visitor may instead see the list/grid choice their browser remembers.
All parameters
Everything the script tag accepts.
| Attribute | Required | Values / default | What it does |
|---|---|---|---|
data-key | yes | pk_… |
Your publishable API key. Identifies your company; only published events are shown. |
data-target | no | CSS selector | Element the list renders into. If omitted — or the selector matches nothing — the widget renders
itself directly before its own <script> tag. |
data-layout | no | list (default) · grid · full |
Initial display layout. Anything unrecognised falls back to list. |
data-switcher | no | off |
Hides the list/grid switcher icons and locks the layout. The switcher is never shown for
data-layout="full". |
data-toolbar-target | no | CSS selector | Renders the switcher icons into your own element — a slot in a section heading, say — instead of above the list. |
data-page-size | no | positive integer | Shows the first N events with a “Load more (X more)” button. Unset shows all. Works in every layout, and the revealed count survives auto-refreshes. |
data-category-filter | no | off |
A category dropdown appears automatically once your published events span 2+ categories. Set
off to hide it. |
data-lang | no | BCP-47 locale | Language for content and chrome. Event text is served in that language where you have a
translation, falling back to the event's base language. Built-in UI text covers
en, zh-Hant, zh-Hans, ja; others get English
chrome. Unset follows the visitor's browser, which is what most sites want. |
data-permalink-base | no | URL | Base for the Share button's links. Defaults to the page the widget is on — set it if you embed in several places and want one canonical events page. |
Share links append ?evw=<eventId>. A visitor
arriving with it gets filters and paging cleared, the event scrolled to, and its detail opened. Set your
Company URL in Profile and links switch to /s/<eventId>, which serves per-event
OpenGraph tags so chats unfurl a real preview card.
Layouts
list default
Compact rows: thumbnail, title, date, location, two-line description, spots-left badge. Clicking a row expands it in place with the banner, full description, and the registration form.
grid
Responsive card grid, roughly 230px columns. Clicking a card opens a full-height drawer from the right with the banner, description, location, and form. Closes on ✕, backdrop, or Escape.
full
Large cards with everything visible at once: 3:1 banner, full description, registration button inline. Best for one or two flagship events.
Unless disabled, a visitor's list/grid choice is remembered in
their browser and overrides data-layout on return visits.
Styling, the registration form, and troubleshooting are covered in docs/EMBED.md.