Events

An event is something happening at a particular time that you want listed on your site, such as a class, a workshop, a screening, or a gig. Each one carries a date and a time, and can send visitors somewhere to book. Events are a Pro plan feature.

You manage them from the Events page in the dashboard. Event types are created and edited from inside the event form, where you pick them. The same schedule can be managed over the API, where a token with the content scope can list, create, update, and delete both. Events belong to a single site, so every site in your workspace keeps its own schedule.

Event types

An event type is a category. A yoga studio might sort its schedule into Breathwork and Vinyasa, while a cinema might use Matinee and Late Show. Setting up a few first makes it easier to control what appears on a given page later.

Every type has a name and a URL slug, and can also carry a description and an image. You can point a type at one of your pages, which gives visitors a way to read about it in full. To add one, open any event, open its event types picker, and choose Create new event type. Each type in the picker has an Edit button that opens the same form, where you can also set its position. That order carries through to the site.

Changing a type’s slug carries over to every event filed under it and to the newsletter subscribers who chose it as an interest. Event widgets on your pages are the exception. A widget set to show one type keeps the slug it was given, so edit it to pick the renamed type.

Deleting a type leaves its events alone. They stay published and stop being categorized under it, and subscribers who chose it lose it as an interest.

Adding an event

An event needs a title, a start date and time, and a timezone. The timezone is stored on the event and used whenever the time is displayed, so a listing reads correctly for visitors wherever they are.

Everything else is optional:

• A description, which visitors can expand underneath the event.
• One or more event types, which is what the filtering works on.
• A price, written however it should read, such as “£15” or “Free”.
• A capacity, a location, and an image.
• A booking URL, which becomes a “Book now” button.

Marking an event hidden keeps it off the site without deleting it, which helps while you are still pinning down the details.

Putting events on a page

Add an events list to any page from the editor’s widget menu. You can narrow it to a single event type and cap how many events appear, or leave both empty to list everything upcoming.

The list renders as a table on wider screens and as cards on phones. Any row can be expanded to read the description, and events with a booking URL get a button next to them. When nothing is upcoming, the page shows a short line saying so.

Past events drop off the list, though the change takes effect on your next deploy rather than the moment the event finishes. If your schedule matters, deploy after it changes.

Showing what you offer

A second widget lays out your event types as a grid of cards in two or three columns, using each type’s image and description. Cards link through to the page a type points at. It suits the top of a landing page, introducing what you run before the schedule itself appears further down.