Skip to main content

Calendar Layout

The **Calendar** format displays events in a monthly grid, one month at a time, with navigation links to move between months.

Updated today

Calendar Layout

The Calendar format displays events in a monthly grid, one month at a time, with navigation links to move between months.

How It Looks

The grid renders as a standard HTML table with:

  • A caption row showing the current month and year (e.g. "April 2026")

  • A header row with abbreviated or full weekday names

  • A body where each cell represents one calendar day

  • A footer row with previous-month and next-month navigation links

Days that have at least one event are rendered as links. Hovering a day with multiple events shows a tooltip listing each event title and time. Clicking a day with a single event goes directly to that event page; clicking a day with multiple events goes to the day archive.

Today's date receives the CSS class sp-highlight.

Month Navigation

The footer of the grid contains:

  • A previous month link (labeled with the abbreviated month name and a left arrow) — visible only if events exist in a prior month within the calendar's filter

  • A next month link (labeled with the abbreviated month name and a right arrow) — visible only if events exist in a later month within the calendar's filter

Navigation preserves the current page URL and appends ?sp_year=YYYY&sp_month=M query parameters.

Weekday Display

The initial shortcode parameter controls how weekday names appear in the header row:

  • initial="1" (default) — single initial letter (e.g. "M", "T", "W")

  • initial="0" — abbreviated name (e.g. "Mon", "Tue", "Wed")

The first day of the week follows the Settings > General > Week Starts On setting in WordPress.

Month Caption Tag

By default the month/year caption is wrapped inside the table's <caption> element. The caption_tag shortcode parameter overrides this with any HTML heading tag (e.g. caption_tag="h3" wraps the caption in <h3> tags inside the caption).

Setting show_all_events_link="1" in the shortcode appends a View all events link below the grid, pointing to the calendar's permalink page. This link only appears when an id is provided.

Shortcode

[event_calendar id="42"]

Full parameter reference: see the Event Calendar Shortcode article.

When viewing the calendar post in the WordPress admin, the Feeds meta box displays subscription links for Apple Calendar, Outlook, and Google Calendar. These links are not rendered on the front-end calendar grid itself; they are admin-only aids for copying feed URLs. See the iCal and Feed Integration article for details on the feed format.

Did this answer your question?