Three HappenBoard blocks show your next events with almost no setup: Upcoming Events, Events List and Events Grid. They differ in how much they show, from a few linked lines to cards with images.
All three look forward from now, across your whole calendar. When you need past events, a date range or a filter by category or venue, use the Event Query Loop block instead.
Add a listing block
- Edit the page, post or template where the list should appear.
- Open the block inserter and add Upcoming Events, Events List or Events Grid from the HappenBoard category.
- Set its options in the block settings sidebar.
- Save.
Upcoming Events
One linked line per date: the date and time, then the event title. It suits a sidebar or a footer. It lists only dates that have not started yet.
| Setting | What it does | Default |
|---|---|---|
| Number of events to show | How many dates to list, from 1 to 20. | 5 |
Events List
A list in date order. Each entry has a day and month badge, the title as a link, and a line with the date, time and details. A date that has started stays on the list until it ends.
| Setting | What it does | Default |
|---|---|---|
| Number of events | How many dates to list, from 1 to 50. | 10 |
| Show venue | Adds the venue name to the details line. | On |
| Show organizer | Adds the organizer name to the details line. | Off |
| Group by month | Splits the list into sections headed by the month and year. | On |
Events Grid
Cards in columns, a good fit for a landing page. Like the Events List, it keeps a date that has started until it ends. Its settings sit in two panels, Layout and Display.
| Setting | What it does | Default |
|---|---|---|
| Number of events | How many cards to show, from 1 to 24. | 6 |
| Columns | From 1 to 4. | 3 |
| Featured image | Shows the event’s featured image at the top of the card. An event without one gets a card without an image. | On |
| Date and time | Shows when the event starts. | On |
| Venue | Shows the venue name. | On |
| Excerpt | Shows the event’s excerpt under the title. | Off |
On an event category or tag page, the grid lists only the events of that category or tag, sub-categories included. When there are more events than cards, it adds Previous page and Next page links. This is how the default category pages work: see categories, tags and colors.
What the three have in common
- Published events only, from now on. None of them shows past events.
- One entry per date: a recurring event appears once for each of its dates, and each entry opens the event page on that date. A date you removed with Skip is left out.
- Dates and times follow your site’s formats and time zone, set in Settings → General.
- With nothing to show, they print No upcoming events. instead of an empty space.
- Wide and full width alignment, plus the usual color, typography and spacing settings.
Let visitors filter the list
The three blocks have no filter settings. With HappenBoard Pro, you can add the Events Filter Bar to the same page. Visitors then narrow an Events List or an Events Grid by category, tag, venue or search words. Upcoming Events ignores the Filter Bar and keeps showing the next dates.
Which one to choose
- A short teaser in little space: Upcoming Events.
- A programme people read in order: Events List.
- A page that should look good: Events Grid.
- Past events, this week only, or one category: Event Query Loop.
You can use two on the same page, for example a grid of the next six events at the top and a longer list further down.
Next steps
- The Event Query Loop block: filter by date range, category, tag, venue or organizer.
- The Calendar block: show the same events as a calendar.
- The HappenBoard blocks: overview: see every block at a glance.