Skip to content

Put your events on your website

The KonversAI events widget shows your published events on your own web page, one day at a time. Visitors see the coming weeks in a calendar, coloured by how much room each day has. They pick a day, see that day’s events as a list, and select Sign up to open the event’s signup form right under the event. You paste a short script on your page. The script names your workspace, and optionally the events to show and the language.

To find the values for the script, you need to open the event page in the KonversAI console: a tenant administrator, or any team member whose role includes View events and participants. If you do not see Events under Booking in the left sidebar, you do not have that permission, or your tenant does not have the Events feature.

On your website, you need a person who can edit the HTML, or who can paste a script into your content management system.

Your tenant needs the Events feature. Create at least one event, publish the event, and add dates. See Set up an event, Share the event signup page and Add dates to an event. The events widget shows only published events.

For a paid event, make sure online payment is connected under Payments > Settings. Without online payment, the events widget lists the dates of a paid event as closed for signup.

  1. Select Booking in the left sidebar of the KonversAI console, then select Events.
  2. Select the name of an event you want on the page, then select Signup page. A panel opens with the heading Signup page.
  3. Read the link in the panel. The link has this shape: https://app.example.com/events/your-company/beginners-course/. The first part, https://app.example.com, is the KonversAI address. your-company is your workspace. beginners-course is the event.
  4. Write the script below, with the KonversAI address in src and your workspace in data-tenant.
  5. Optional: to show some events only, list them in data-event-templates, separated by commas. Repeat steps 2 and 3 to find the name of each event. Leave data-event-templates out to show every published event.
  6. Optional: set data-locale to nb for Norwegian, sv for Swedish or en for English.
  7. Paste the script into your page HTML where the events widget should appear, then publish the page.
  8. Open the page in a browser. The events widget shows the coming weeks, and the list of events for the first day with an open event.
<script
src="https://app.example.com/widget-assets/events.js"
data-tenant="your-company"
data-event-templates="beginners-course,bowling"
data-locale="nb"
></script>

To place the events widget inside an element somewhere else on the page, add data-target with a CSS selector, for example data-target="#events". Without data-target, the events widget appears right after the script tag.

The events widget colours each day in its calendar by the events on that day:

  • Green: at least one event that day takes signups and has room.
  • Yellow: every event that day that takes signups is nearly full, with less than a fifth of its seats left.
  • Red: the events that day take signups, but no seat is free. A waiting list does not count as a free seat.
  • Grey: no event that day, or signup has closed for every event that day.

Each event shows its start and end time, its title, the text you gave the date, a status and the price. The status is Open, Few seats left, Full, Full · waiting list or Signup closed. The number of seats left appears only when a date is down to 8 seats or fewer. A date whose signup has closed stays in the list, greyed out, so visitors know the date was there.

What happens when a visitor selects Sign up?

Section titled “What happens when a visitor selects Sign up?”

The event’s own signup form opens under the event, inside the events widget. The visitor fills in the form there, and gets the same confirmation email as on the event’s signup page. On a paid event, the payment page opens in a new tab. A full date with a waiting list shows Join the waiting list instead of Sign up. A full date without a waiting list, and a date whose signup has closed, have no working button.

Why does the events widget not show a cancelled date?

Section titled “Why does the events widget not show a cancelled date?”

The events widget never shows a cancelled date, or a date of an event that is a Draft or Archived. To show an event again, open its Settings page in the KonversAI console, choose Published in the status list at the top, and select Save. See Change or cancel an event date.

Why is there a dropdown above the calendar?

Section titled “Why is there a dropdown above the calendar?”

The events widget shows more than one event. The dropdown starts at All events and lists each event, so visitors can narrow the calendar to one. To show one event without a dropdown, set data-event-templates to that event alone, for example data-event-templates="beginners-course".

One of the events I listed does not show. Why?

Section titled “One of the events I listed does not show. Why?”

The name in data-event-templates does not match a published event. Open the event in the KonversAI console, select Signup page, and copy the name from the link: the part after your workspace, such as beginners-course. Check that the event is Published. The events widget skips a name it does not find, and shows the other events.

The page says “These events are not available.” What is wrong?

Section titled “The page says “These events are not available.” What is wrong?”

The data-tenant value does not match your workspace, or your tenant does not have the Events feature. Open any event in the KonversAI console, select Signup page, and copy your workspace from the link: the part after /events/. Put that value in data-tenant.

Which language does the events widget use?

Section titled “Which language does the events widget use?”

The events widget uses the language in data-locale: nb for Norwegian, sv for Swedish or en for English. Without data-locale, the events widget follows the language the visitor’s browser prefers, then the Default language of your tenant at Settings > AI preferences, then English. Event titles and texts show exactly as you typed them.

Last reviewed . Tell us when a step no longer matches the product.