Skip to main content

How Events Appear on Your Site

Events Manager shows your events to visitors as soon as you publish one. It creates an events page with a searchable list, gives every event, location, category and tag a page of its own, and offers blocks, shortcodes and widgets for putting events anywhere else. This page explains what is already there, what controls its content, and which tool to reach for when you want something different.

The events page, as created at installation.

The pages Events Manager uses​

When it is first activated, Events Manager creates a handful of ordinary WordPress pages and takes over their content. You choose which page does which job in Events then Settings then Pages.

PageChosen inWhat visitors see there
Events pageEvent List/ArchivesThe list of upcoming events, with the search form above it.
Locations pageLocation List/ArchivesThe list of locations.
Categories pageEvent CategoriesThe list of event categories.
Tags pageEvent TagsThe list of event tags.
My bookings pageOther PagesA logged-in visitor's own bookings. See My Bookings.
Edit events page, Edit locations page, Manage bookings pageOther PagesFront-end screens where members manage their own events, locations and bookings. Not set by default. See Event submission forms.

The first five are created for you. On a new site they are at /events/, /events/locations/, /events/categories/, /events/tags/ and /events/my-bookings/.

You can rename these pages, move them or add them to a menu like any other page. What you type in the page editor is replaced by the list. To keep your own text around it, write the word CONTENTS on a line of the page, and the list is placed there with your text above and below.

Choosing the events page.

Events page options​

These are in Events then Settings then Pages then Event List/Archives.

SettingDefaultWhat it does
Events pagethe page created at installationThe page that shows the event list. Choose [No Events Page] to have none and build your own with blocks or shortcodes.
Show events search?YesShows the search form above the list.
Display calendar in events page?NoShows a calendar in place of the list.
Event list scopeFuture eventsThe date range the page shows.
Event List Limits10How many events one page of the list holds. More are reached with page links.
Default event list orderingStart date, start time, then name, ascendingThe order of the list.
Are current events past events?NoAn event that has started but not ended counts as current and stays in the list. Yes drops it once it has started.
Include cancelled events?NoWhether events with the Cancelled status stay in lists. See Cancel an event.

The other list pages have the same kind of options in their own sections.

Single event, location, category and tag pages​

Every published item has its own address:

ItemExample addressShows
Event/events/harbor-lights-jazz-night/Date, time, location, description, and the booking form if bookings are on.
Location/locations/harbor-community-hall/Address, description and the upcoming events held there.
Category/events/categories/music/The category's description and its upcoming events.
Tag/events/tags/live-music/The tag's upcoming events.
Organizer/events/organizers/ followed by the organizer's nameThe organizer's upcoming events, when organizers are enabled. See Event organizers.

A single event page in the default format.

The first parts of these addresses are slugs you can change: event and location slugs with the event types in the General settings, category and tag slugs under Permalink Slugs in Events then Settings then Pages.

Two settings in Events then Settings then Pages then Event Pages decide how an event page is built (locations have the same pair under Location Pages):

SettingDefaultWhat it does
Display events asPagesWhich theme template wraps the event. Pages uses your theme's page template, which usually has no author or date line. Posts uses the post template. Templates your theme provides are listed too.
Override with Formats?YesYes fills the page with Events Manager's single event format, so the date, location and booking form appear without theme changes. No shows only what you typed in the event's description.

Formats decide what is shown​

Each of these lists and pages is produced from a format: a piece of HTML containing placeholders such as #_EVENTNAME, #_EVENTDATES and #_LOCATIONLINK, which are replaced with the real details of each event. Conditional placeholders such as {has_bookings} show or hide parts of a format depending on the event.

Events Manager comes with a built-in format for everything: the event list, the grid, the single event page, the calendar previews, location and category pages, and more. Until you change something, those are used.

To write your own:

  1. Go to Events then Settings then Formatting.

  2. Open the Advanced Mode section at the top and click Enable Advanced Mode.

  3. Click Save Changes. The sections below now show their format boxes.

  4. Open the section for the thing you want to change, for example Events, and set Override Default Formats? to Yes for the format in question, such as the event list or the single event page.

  5. Edit the format, and save.

Advanced Mode makes the format boxes editable, one group at a time.

With Advanced Mode, any format you have not overridden keeps the built-in version, including improvements that arrive in updates. Super Advanced Mode makes every format come from the boxes on this page. Sites that started on a version before 6 are in Super Advanced Mode already, with their old formats kept.

Tick Enable Code Editor for Formats at the top of the tab for syntax highlighting in the larger boxes.

The sections of the Formatting tab:

SectionHolds
EventsThe default view, list and grid formats, grouped list defaults, the single event page format and excerpts.
Search FormThe search form fields and the views visitors may choose.
Date/TimeHow dates and times are written by placeholders such as #_EVENTDATES.
CalendarCalendar size, style, previews, and the iCal feed settings.
Locations, Event Categories, Event TagsThe list and single page formats of each.
RSSThe RSS feed.
MapsMap size and the content of map balloons. See Google Maps.

List, grid, map and calendar views​

The same set of events can be laid out in five ways:

ViewLayout
ListOne event per row, with image, date, time and location.
Grouped ListsThe list under date headings, by month unless you change Grouped list default.
GridCards in columns, at least 250 pixels wide each.
MapMarkers on a map. Needs Google Maps.
CalendarA month calendar.

Default View, at the top of Events then Settings then Formatting then Events, sets the view the events page opens in. Visitors switch between views with the view button in the search bar, and View Types in the Search Form section sets which ones they are offered. A shortcode chooses its own with view="grid".

Which should I use?​

For most sites the events page and the single pages are enough. When you want events somewhere else, such as the home page, a sidebar or a landing page, you have four tools.

BlocksShortcodesWidgetsTemplate files
Where it goesAny page, post or template edited with the block editorAnywhere text is acceptedSidebars and footers of classic themesYour theme's PHP files
What it can showEvents list, calendar, locations listEverything: lists, grids, maps, calendars, search forms, single items, formsEvents list, calendar, locations listEverything
FiltersScope, category, numberEvery search attributeScope, category, numberEvery search attribute
Search form and view switchingNoYesNoYes
How you set it upA settings panel with a live previewTyping attributesA formWriting PHP
Skill neededNoneComfortable copying and editing a line of textNonePHP and HTML

In practice:

  • Use a block when the page is built in the block editor and you want upcoming events, a calendar or venues with a few options.
  • Use a shortcode when you need a filter or a layout the blocks don't offer (a tag, a country, a grid, a map, a search form, pagination), or when your page builder has no block editor.
  • Use a widget for a sidebar or footer in a classic theme.
  • Use template files or template tags when a developer is building the theme and wants full control of the markup.

A shortcode fits inside a block page too, in the Shortcode block, so the choice is never exclusive.

Go further​

Troubleshooting​

The events page shows my own text and no events​

The page is not chosen as the Events page. Select it in Events then Settings then Pages then Event List/Archives.

A single event page shows only the description​

Override with Formats? is set to No in Events then Settings then Pages then Event Pages, or your custom single event format has lost its placeholders. Set it to Yes, and if the page is still bare, turn Override Default Formats? off for the single event page to return to the built-in format.

An event page shows "posted by" and a date under the title​

Your theme is using its post template. Set Display events as to Pages.

I can't find the format boxes​

They are hidden until Advanced Mode is on. See Formats decide what is shown.

Event, location or category pages give a "page not found" error​

Go to Settings then Permalinks and click Save Changes to rebuild the address rules. If it persists, see Troubleshooting.