Embed event registrationYour events.
On any website.

Two lines of HTML put your event list — with registration built in — on your own site. Paste it once; everything after that happens in your dashboard.

Quick start

  1. Copy your publishable key. In the dashboard, open API keys and copy the key that starts with pk_.
  2. Paste the snippet where the events should appear, with your key in place of pk_….
  3. Publish an event in the dashboard. It shows up on your page — no further changes to your site, ever.
<div id="events"></div>
<script src="https://events-app.vicosys.com.hk/widget.js"
        data-key="pk_…"
        data-target="#events"
        defer></script>
Use the publishable key (pk_) only. It's made to be seen in a web page. Never paste your secret key (sk_) into a website — it belongs on your own server.

Where to paste it

It works anywhere you can add HTML. Paste it as code, not as normal text — most builders have a block for exactly that.

WordPress

In the block editor, add a Custom HTML block and paste the snippet. On WordPress.com, scripts need a plan that allows custom code.

Wix

Add Embed Code → Embed HTML and paste the snippet. Wix shows it in a box — drag the box tall enough for your list.

Squarespace

Add a Code block and paste the snippet. Scripts in code blocks need a Squarespace plan that supports custom code.

Shopify

In the theme editor, add a Custom Liquid section to the page and paste the snippet.

Webflow

Drag in an Embed element and paste the snippet. Custom code needs a paid site plan.

Plain HTML or any CMS

Paste it into the page's HTML where the list should go. Put it on as many pages as you like.

Layouts

Pick a starting layout with data-layout. Visitors can switch between list and grid themselves, and their choice is remembered.

list

List

Compact rows with a thumbnail, date and place. Click a row and it opens in place with the full details and the form. The default.

grid

Grid

Picture cards that fit your page width. Click one and the details slide in from the side.

full

Full

Large cards with everything visible at once. Best for one or two flagship events.

<div id="events"></div>
<script src="https://events-app.vicosys.com.hk/widget.js"
        data-key="pk_…"
        data-target="#events"
        data-layout="grid"
        data-page-size="6"
        defer></script>

All options

Add any of these to the script tag. Only data-key is required.

AttributeRequiredValuesWhat it does
data-keyyespk_…Your publishable key, from the dashboard's API keys tab. Safe to show in a web page — it can only list your published events and take registrations.
data-target—CSS selectorWhere the list appears. Leave it out and the widget appears right where the script tag is.
data-layout—list · grid · fullThe starting layout (default list).
data-switcher—offHides the list/grid buttons and locks the layout. Never shown for full.
data-toolbar-target—CSS selectorPuts the list/grid buttons in your own element, e.g. beside your section heading.
data-page-size—a number, e.g. 6Shows that many events first, with a “Load more” button for the rest. Default: all.
data-category-filter—offA category dropdown appears when your events span two or more categories. off hides it.
data-lang—a language code, e.g. en · zh-Hant · ja
Fixes the widget's language. Usually not needed: without it, the widget follows your page's language. See Languages.
data-permalink-base—a URLWhere Share links point. Use it if the widget sits on several pages and you want one events page.

Languages

The widget's own text — buttons, form labels, messages and dates — comes in 11 languages.

Other codes work too, such as zh-TW or en-GB: the widget uses the closest language in the list, and English if there is none. For your event content, use the same codes you added under Languages in your dashboard settings.

Need a language that isn't in the list? Tell us which one, and we'll look at adding it.

Your event content — title, description, location, form questions — appears in the widget's language when you've added a translation for it in the dashboard, and in your main language otherwise. How many languages you can use depends on your plan.

The widget follows your page's language, read from the page's <html lang> tag. Multilingual sites and CMSs such as WordPress with Polylang or WPML already set it for each language, so there's nothing to add. If your pages don't set it, add data-lang to the snippet instead, for example data-lang="zh-Hant" on your Traditional Chinese pages.

When a page sets neither, the widget uses the visitor's browser language if it's one of your languages, and your main language if it isn't. Buttons and event text then always appear in the same language.

If your site switches language without loading a new page, the widget switches with it as soon as <html lang> changes, and keeps the visitor's filters. To switch it from your own code, call window.VicoEvents.setLang("zh-Hant").

Sharing & links

Every event has a Share button: copy link, WhatsApp, Facebook, X, LinkedIn, email, or the phone's own share sheet. A shared link opens your page with that event already open.

Set your Company URL in the dashboard's Profile and shared links also show a proper preview card in chats and social feeds — the event's title, summary and banner, in the sharer's language.

Match your brand

The widget has a clean, neutral look and doesn't touch the rest of your page. To change it, add rules for its evw- classes to your own stylesheet — yours win.

/* your brand colour on the buttons */
.evw-btn { background: #14532d; }
/* squarer cards */
.evw-card { border-radius: 4px; }
/* the “spots left” badge */
.evw-badge { background: #ecfdf5; color: #047857; }

Other useful classes: evw-title, evw-meta, evw-desc, evw-banner, evw-thumb, evw-gcard, evw-form, evw-input.

What visitors see

  • Only published events, soonest first. Drafts and cancelled events never appear; events with a publish period appear only during it.
  • Live availability — “3 left”, “Sold out”, or a waitlist when you've turned one on.
  • Registration dates — “Registration opens …” before it opens, “Registration closed” after.
  • Your form — name, email and your own questions, with a clear message if anything is missing. One registration per email per event (per date, for recurring events).
  • A confirmation on screen and by email, with a link to their QR ticket.
  • Always current — the list refreshes itself when visitors come back to the tab and every minute, but never while someone is filling in the form.
  • Accessible and calm — works with the keyboard, and animations switch off for visitors who prefer reduced motion.

Troubleshooting

What you seeWhy, and the fix
Nothing appears at allSome editors strip <script> tags from normal text. Use the builder's HTML or code block (see Where to paste it).
“Unable to load events right now”The data-key is wrong or was rotated. Copy the current publishable key from the dashboard's API keys tab.
An event is missingIt isn't published yet, it's outside its “publish from / until” period, or the key belongs to another account.
The list is cut offYour builder shows code in a fixed-height box. Make the box taller.
Event text stays in EnglishAdd a translation for that language on the event in the dashboard; the widget's own buttons translate automatically.
“No longer open for registration” on submitThe event closed or filled up after the page loaded. The list refreshes itself straight after.

Prefer your own design?

Everything the widget does is available through the API: list your events and take registrations with the same publishable key, or manage events from your own systems with the secret key on the Pro and Business plans. See the API reference.