Events List Block
The Events List block (eventonomy/events-list) displays your published events as a list or grid, with a Load more control so visitors can page through without leaving the page.
When to Use It
Add it to your Events page as the main browsing surface, either alongside the Calendar block or on its own. It's also a good fit anywhere you want a filtered slice of events, such as a single category page.
How to Add It
Block Editor:
- Open your Events page in the Block Editor.
- Click + and search for Eventonomy Events List.
- Insert the block.
- Open the block's Settings panel in the editor sidebar to adjust the layout, per-page count, or category.
Shortcode:
[eventonomy_events per_page="6" view="list" category="music"]
Settings
| Setting | Attribute | Type | Default | Description |
|---|---|---|---|---|
| View | view |
string | (empty) | The layout: grid, list, or upcoming (a date-grouped agenda: Today / Tomorrow / This week / This weekend / Next week / Later). Leave empty for the site default. |
| Per page | perPage |
number | 10 | How many events show before visitors need to click "load more." |
| Category | category |
string | (empty) | Limit the list to a single event category. Leave empty to show every category. |
What Visitors Can Do
Visitors browse published events in the layout you've chosen and click Load more to bring in additional events without a page reload.