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.