Skip to main content

Event Blocks (Block Editor)

FreeSince 7.3Included in the free Events Manager plugin.

Events Manager adds three blocks to the WordPress block editor: Events List, Events Calendar and Event Locations. Use them to put upcoming events, a calendar or your venues on a page, in a post, or in a block theme template, and set what they show from the block's settings panel.

The blocks are there whenever you edit with the block editor. They don't depend on which editor you use for events themselves. That choice, the Editor option in Events then Settings then General then General Options, is covered in The event editor.

VideoCalendars and event blocks2:54

Add a block​

  1. Open a page or post in the block editor, or a template in Appearance then Editor.

  2. Click the + block inserter and look for the Events Manager category, or type events in the search box.

    Search for events to find the three blocks. They also have their own Events Manager category in the inserter.

  3. Click Events List, Events Calendar or Event Locations. The block appears with a live preview of your real events.

  4. Select the block and open the Settings sidebar (the panel icon at the top right). Change the options under the block's settings panel. The preview updates as you go.

  5. Save or publish the page.

Each block can be set to Wide width or Full width from its toolbar if your theme supports those alignments.

Events List​

A compact list of events: a thumbnail or date badge, the event name as a link, the date and the town. It suits a sidebar, a footer or a "coming up" section on a home page.

The Events List block with its settings panel open.

Settings under Events list settings:

SettingDefaultWhat it does
TitleemptyA heading printed above the list. Left empty, the block prints Events.
Number of events5How many events to show.
ScopeFutureWhich dates to include: Future, Past, All, Today, This week or This month.
Order bystart date, start time, event nameThe fields the list is sorted by.
OrderAscendingAscending or Descending.
Category IDs0One category, or several separated by commas, such as 4,5. Category names and slugs work too, such as Music or music. 0 shows every category.
Show "all events" link at bottomoffAdds a link to your events page under the list.
"All events" link textall eventsAppears when the link is switched on.
No events messageNo eventsShown when nothing matches.

Under Output format (advanced), which is closed until you click it, three boxes let you replace the HTML of the list with your own, using placeholders:

SettingWhat it does
List header formatHTML printed once before the events, for example <ul>.
List item formatHTML printed for each event, for example <li>#_EVENTLINK, #_EVENTDATES</li>. Leave it blank for the built-in compact format shown above.
List footer formatHTML printed once after the events, for example </ul>.

The same block as visitors see it.

note

A category's ID is the tag_ID number in the address bar when you edit it in Events then Event Categories.

Events Calendar​

A month calendar with arrows to move between months. Days with events are marked, and clicking one shows what's on. How the calendar behaves is explained in Using event calendars.

The Events Calendar block with its settings panel open.

Settings under Calendar settings:

SettingDefaultWhat it does
TitleemptyA heading printed above the calendar. Left empty, the block prints Calendar.
Show long eventsoffWhen on, an event that lasts several days is marked on every day it covers. When off, only on its first day.
Future events onlyoffWhen on, past events are left out and visitors can't go back before the current month.
Category IDs0Limits the calendar to one or more categories. 0 shows every category.
ArchetypeDefaultAppears only when your site has custom event types. Chooses which type the calendar shows.
Calendar sizeResponsiveResponsive changes size to fit the space. Large, Medium and Small fix it. See calendar sizes.
Event styleDefault (site setting)How events are marked on a day: Pills, Single dot, Multiple dots or Rings. See event styles.
Events per dayblankThe most events shown on one day. 0 means no limit. Blank uses Calendar events/day limit from your settings.

The calendar block on the front end, at the width of a content column.

Event Locations​

A compact list of locations: an image, the name as a link, and the address. This block is offered only while Enable locations? is Yes in Events then Settings then General then General Options.

The Event Locations block with its settings panel open.

Settings under Locations list settings:

SettingDefaultWhat it does
TitleemptyA heading printed above the list.
Number of locations5How many locations to show.
ScopeFutureFuture, Past or All. In Events Manager 7.5 this does not change which locations are listed: every published location is included.
Order byEvent start date/time, location nameSort by when each location's events take place, or by Location name.
OrderAscendingAscending or Descending.
No locations messageNo locationsShown when there are no locations.

Output format (advanced) has the same three boxes as the Events List block, and takes location placeholders such as #_LOCATIONLINK and #_LOCATIONTOWN.

To list only the locations that have upcoming events, use the shortcode [locations_list eventful="1" scope="future"] in a Shortcode block.

What the blocks can't do​

The blocks cover the common cases. For anything below, use a shortcode in a Shortcode block:

  • Filtering by tag, location, country, or a custom date range.
  • Showing a search form above the list, or letting visitors switch between list, grid and map views.
  • Grid, grouped list and map views.
  • Pagination.

The blocks print the same HTML as the widgets of the same names, so CSS you wrote for one applies to the other.

The Event Details block​

When you edit an event in the block editor with the canvas layout, a fourth block called Event Details sits under the title and holds the event's dates, recurrence and booking settings. It is part of the event editor: it can't be added from the inserter, moved or removed, and it prints nothing on the front end. See The event editor.

Troubleshooting​

The Events Manager blocks are not in the inserter​

Check that Events Manager is version 7.3 or later and that you are in the block editor. A page builder or the Classic Editor plugin replaces the block editor, and then the blocks have nowhere to appear. Use shortcodes there instead.

Event Locations is missing but the other two are there​

Locations are switched off. Set Enable locations? to Yes in Events then Settings then General then General Options.

The list is empty​

The block shows published events that match its settings. Check Scope (the default is future events only) and Category IDs. An ID that doesn't exist matches nothing.

My custom format prints nothing for each event​

List item format replaces the whole item, so it must contain at least one placeholder, such as #_EVENTLINK. Clear the box to go back to the built-in format.