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.
pk_.pk_….<div id="events"></div> <script src="https://events-app.vicosys.com.hk/widget.js" data-key="pk_…" data-target="#events" defer></script>
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.It works anywhere you can add HTML. Paste it as code, not as normal text — most builders have a block for exactly that.
In the block editor, add a Custom HTML block and paste the snippet. On WordPress.com, scripts need a plan that allows custom code.
Add Embed Code → Embed HTML and paste the snippet. Wix shows it in a box — drag the box tall enough for your list.
Add a Code block and paste the snippet. Scripts in code blocks need a Squarespace plan that supports custom code.
In the theme editor, add a Custom Liquid section to the page and paste the snippet.
Drag in an Embed element and paste the snippet. Custom code needs a paid site plan.
Paste it into the page's HTML where the list should go. Put it on as many pages as you like.
Pick a starting layout with data-layout. Visitors can switch between list and grid themselves, and their choice is remembered.
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.
Picture cards that fit your page width. Click one and the details slide in from the side.
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>
Add any of these to the script tag. Only data-key is required.
| Attribute | Required | Values | What it does |
|---|---|---|---|
data-key | yes | pk_… | 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 selector | Where the list appears. Leave it out and the widget appears right where the script tag is. |
data-layout | — | list · grid · full | The starting layout (default list). |
data-switcher | — | off | Hides the list/grid buttons and locks the layout. Never shown for full. |
data-toolbar-target | — | CSS selector | Puts the list/grid buttons in your own element, e.g. beside your section heading. |
data-page-size | — | a number, e.g. 6 | Shows that many events first, with a “Load more” button for the rest. Default: all. |
data-category-filter | — | off | A 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 URL | Where Share links point. Use it if the widget sits on several pages and you want one events page. |
The widget's own text — buttons, form labels, messages and dates — comes in 11 languages.
| Code | Language |
|---|---|
en | English |
zh-Hant | 繁體中文 |
zh-Hans | 简体中文 |
ja | 日本語 |
ko | 한국어 |
es | Español |
fr | Français |
de | Deutsch |
pt | Português |
th | ไทย |
vi | Tiếng Việt |
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").
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.
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 you see | Why, and the fix |
|---|---|
| Nothing appears at all | Some 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 missing | It isn't published yet, it's outside its “publish from / until” period, or the key belongs to another account. |
| The list is cut off | Your builder shows code in a fixed-height box. Make the box taller. |
| Event text stays in English | Add a translation for that language on the event in the dashboard; the widget's own buttons translate automatically. |
| “No longer open for registration” on submit | The event closed or filled up after the page loaded. The list refreshes itself straight after. |
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.