The Calendar block shows your events in a calendar that visitors browse by month, week, day or agenda. It works on any page, post or template, and the only choice you need to make is the view visitors see first.
Your events archive may already have one. The default events archive shows a Calendar above the list of upcoming events, on block themes and classic themes alike. You can change it as described in Patterns and Site Editor templates.
Add the calendar to a page
- Edit the page where the calendar should appear.
- Open the block inserter and add Calendar from the HappenBoard category.
- In the block settings sidebar, open the Calendar panel and set the options below.
- Save the page.
Settings
| Setting | What it does | Default |
|---|---|---|
| Default view | The view visitors see first: Month, Week, Day or Agenda. | Month |
| Show view switcher | Shows the Month, Week, Day and Agenda links in the calendar header. Turn it off to keep everyone on the default view. | On |
| Agenda window (days) | Shown when the default view is Agenda. The number of days one agenda page covers, from 1 to 365. | 30 |
The four views
- Month: a grid of six weeks. Each day lists its events with their start time. The week starts on the day set under Settings → General in WordPress.
- Week: seven columns, one per day. A day with nothing on says No events.
- Day: one day’s events in order of start time, or No events scheduled for this day.
- Agenda: the events of the coming days, grouped by date, or No events in this date range.
How visitors move around
The arrows in the header go back or forward by one month, week, day or agenda page. A Today link appears once the visitor has left the current period.
The calendar changes in place, without reloading the page. The address in the browser changes too, so the Back button and bookmarks work.
When a visitor switches views, the calendar stays on the period they were looking at. Clicking Week while viewing November opens the week of 1 November, not the current week.
You can also link straight to a period. Add one of these to the page address:
?happenboard_month=2026-11opens the month view on November 2026.?happenboard_date=2026-11-14opens the week, day or agenda view on that date.?happenboard_calendar_view=agendaopens the agenda, whatever the default view. It works withmonth,weekanddaytoo.
What the calendar shows
- Published events only, in your site’s time zone and time format.
- A recurring event on each of its dates. A date you removed with Skip is left out.
- Each date of a series links to the event page opened on that date. The date, countdown and calendar links on that page then match the day the visitor clicked.
- An event lasting several days on each day it covers. The first day shows the start time, the next ones show Cont.
- All day in place of a time for an all-day event.
- What is over: days before today are lightly hatched, and events that have ended show their time in normal weight instead of bold.
- Today: tinted, with its day number underlined.
The block has no filters. To show only one category or one venue, use the Event Query Loop block.
On phones and with a keyboard
- On a narrow screen, each day of the month grid shows how many events it has, instead of titles cut short. Tapping the number opens that day.
- On small screens, the week view lists the days one under the other.
- Every link works with the Tab and Enter keys. After a click on an arrow or a view, the focus stays on the same control, and screen readers announce the new period.
Very busy periods
One view lists up to 1,000 dates. When a period has more, the calendar says from which day some dates may be missing. A List the events from that day link then opens the agenda on that day, where the rest appears.
Choose a style
In the block sidebar, the Styles section offers four looks:
- Default: a grid with borders around each day.
- Minimal: no cell borders and more white space.
- Card: the whole calendar in a rounded panel with a soft shadow.
- Bold: a large title, uppercase weekday names, taller cells, and today framed by a thick border.
The block also has the usual color, typography and spacing settings, and wide or full width alignment.
Next steps
- Event listing blocks: add a list of upcoming events under the calendar.
- The Event Query Loop block: show a filtered selection instead.
- Building a single event page: set up the page each calendar entry opens.
- The HappenBoard blocks: overview: see what the other blocks do.