Setting up your events pages

What you're building

One page does two jobs.

It shows your events listing at a URL of your choosing, such as /events. And it shows each individual event at its own URL beneath that, such as /events/autumn-conference, with the full details and the registration form.

You never build a page per event. Publish an event in EventEngine and its page appears under the listing on its own.

Building the page

Step 1: Create the page

1. In HubSpot go to Content › Website Pages and click Create a website page.
2. Pick any drag-and-drop template from your theme, then choose Edit manually.

Step 2: Add both modules

1. Add a section, open the module panel using the + on the left, and search for event.
2. Drag in both EventEngine modules, one below the other. EventEngine Listing is the calendar, grid or list of all your events, with the filters and search box. EventEngine Single is the individual event view, with the registration form.

Both modules have to sit on the same page. That's what lets one page serve the listing and every event beneath it. The page shows the listing when someone visits the top URL, and the single event when they visit an event's URL.

Step 3: Set the page title and URL

In Settings › General, give the page a title and a clean URL slug such as /events. Individual events sit beneath whatever you choose here.

Step 4: Set the data source

This is the step people miss, and missing it is the single most common reason event pages return a 404.

Go to Settings › Advanced, find Dynamic pages, and set Data source to EventEngine Pages.

The listing links each event to a child URL under your page. Without the data source, HubSpot doesn't know those child URLs exist and returns a 404 for every one of them. With it set, the Single module renders the right event at each URL.

Step 5: Publish

Click Publish, or Update if the page is already live.

How to check it worked

Open the page on your live site and check two things.

The listing shows your published event, with its name, date, category and type. If the calendar view is sitting on a month with nothing in it, switch to grid or list view using the icons at the top right.

Clicking the event opens its own page, at its own URL, with the full details and a working registration form.

If both of those work, you won't need to touch this page again.

Troubleshooting

Event pages return a 404. The data source isn't set. Go to Settings › Advanced › Dynamic pages, set Data source to EventEngine Pages, and republish. Check that both modules are on that same page.

The listing appears but looks empty. The calendar is probably showing a month with no events in it. Switch to grid or list view. Also check the event's dates are in the future, because the listing shows upcoming events only unless a visitor ticks the Past Events filter.

A published event isn't on the website at all. Check the event is published in EventEngine, with the green published status on the dashboard, and that its dates are in the future.