The Calendar block

The Calendar block puts a full calendar on any page or template. It has four views, its own navigation, and four style variations.

Adding the block

  1. Edit the page where the calendar should appear.
  2. Insert the Calendar block from the HappenBoard category of the inserter.
  3. Open the block sidebar and adjust the Calendar panel.

On a block theme you may not need to do this at all: the events archive template already contains a Calendar block, as explained in the templates guide.

Settings

  • Default view: Month, Week, Day or Agenda. This is the view a visitor lands on.
  • Show view switcher: shows or hides the four view links in the calendar header. Turn it off to keep everyone on one view.
  • Agenda window (days): appears only when the default view is Agenda. It sets how many days one screen of the agenda covers, from 7 to 180. The default is 30.

The four views

Month

A six-row grid. Days from the neighbouring months fill the corners and are dimmed, today’s cell is highlighted, and each day lists its events with a start time and a link. The grid starts on the week day set in Settings → General.

Week

Seven columns, one per day, each headed by the weekday name and the day number. A day with nothing on shows No events.

Day

One day at a time, as a single list of start times and titles. An empty day shows No events scheduled for this day.

Agenda

A rolling window of the length you set, grouped by date, each group headed by the date and the weekday. When the window holds nothing you get No events in this date range.

Moving around

The header carries a previous arrow, a next arrow, and a Today link that only appears once you have moved away from the current period. One step is a whole month in month view, a week in week view, a day in day view, and one full window in agenda view.

Navigation happens in place. The block fetches the new period and swaps it into the page without a reload, and the address bar is updated so the back button and bookmarking keep working. If the request fails, the browser simply follows the link as a normal page load.

Because the state lives in the address, you can link straight to a period. Add ?happenboard_month=2026-09 to open a given month, ?happenboard_date=2026-09-12 to anchor the week, day or agenda view, and ?happenboard_view=week to force a view regardless of the block’s default.

What the calendar shows

  • Published events only.
  • One entry per date, so a recurring event appears on every date it runs.
  • All-day events show All day in place of a start time.
  • Times in the format set under Settings → General.
  • Up to 500 dates for the period on screen, which is well beyond what a readable month grid holds.

The block has no category, tag or venue filter. When you need a filtered view, reach for the Event Query Loop block instead, or one of the simpler listing blocks when a plain list is enough.

Styles and appearance

The Styles section of the block sidebar offers four variations:

  • Default: the standard bordered grid.
  • Minimal: no cell borders, more whitespace, today marked by colour alone.
  • Card: the whole calendar in a padded, rounded panel with a soft shadow.
  • Bold: a large title, uppercase weekday labels, taller cells and a strongly filled current day.

On top of that you get the usual color, spacing and typography controls, plus wide and full width alignment.

What’s next