Creating a Calendar
A calendar is a saved query that collects events matching specific criteria and displays them in one of several layouts. Once saved, a calendar can be displayed as a standalone page via its permalink, embedded anywhere on your site using its shortcode, or used inside a widget.
Navigation
Go to Events > Calendars > Add New.
Title
Enter a name for the calendar in the top text field. This becomes the post title and is used as the default heading when the calendar is displayed on the front end. You can override the heading with the Heading field in the Details panel without changing the post title.
Format
The Format meta box on the right side of the editor selects the display layout. Choose one:
Calendar — monthly grid view (default)
List — tabular list of events
Blocks — card-style event display
Scoreboard — horizontal scrolling ticker (Pro, requires SportsPress Scoreboard module)
Matrix — head-to-head results grid (Pro, requires SportsPress Results Matrix module)
The format you choose determines which shortcode is generated (e.g. [event_calendar id="…"], [event_list id="…"], [event_blocks id="…"], [event_scoreboard id="…"], [event_matrix id="…"]).
Details Panel
The Details meta box controls which events the calendar collects.
Heading
Heading — Optional override for the title displayed at the top of the calendar on the front end. Leave blank to use the post title.
Status
Status — Filters events by WordPress post status. Options:
All — includes both published (past) and scheduled (future) events
Published — past events only
Scheduled — future events only
Event Format
Event Format — Filters events by their event format (e.g. a specific competition format). Select All to include every event format.
Date
Date — Restricts events to a time window. Options:
All — no date restriction
Yesterday
Today
Tomorrow
Last week
This week
Next week
Date range: — when selected, reveals additional date range fields
When Date range: is selected, two sub-options appear:
Absolute range — enter a From date and a To date (YYYY-MM-DD)
Relative range — enter a number of Past days and Next days; check the Relative checkbox to activate this mode
Match Day
Match Day — Filters events by their match day number. Leave blank to show all match days.
Taxonomies
Three taxonomy selectors appear below the date fields, each populated automatically from the terms assigned to events:
League — filter by one or more leagues (competitions). Selecting Auto follows the league assigned to the context where the calendar is displayed.
Season — filter by one or more seasons. Selecting Auto follows the current season.
Venue — filter by one or more venues.
Leave any selector blank to include all terms.
Team
Team — multi-select dropdown. Choose one or more teams to restrict events to matches involving those teams. Leave blank to include all teams.
Player
Player — multi-select dropdown. Choose one or more players to restrict events to matches involving those players. Leave blank to include all players.
Sort by
Sort by — determines the primary sort field:
Date — sorts by event date (default)
Match Day — sorts by the
sp_daymeta value
Sort Order
Sort Order — Ascending (oldest first) or Descending (newest first).
Columns Panel
The Columns meta box lets you choose which columns appear when the List format is used. Available columns depend on the Title Format and Time/Results Format set in Events > Settings > Event List:
Title / Teams / Home | Away (label changes with Title Format setting)
Time/Results / Time / Results (label changes with Time/Results Format setting)
League
Season
Venue
Article
Match Day
All columns are checked by default.
Events Preview
The Events meta box at the bottom of the editor shows a read-only preview of the events that match the current Details settings, rendered as a table with Date, Event, Time/Results, League, Season, Venue, Article, and Match Day columns (filtered to your Columns selection).
Displaying a Calendar
There are two ways to display a calendar:
As a page — publish the calendar post and visit its permalink. SportsPress renders the calendar using its chosen format template.
Shortcode — copy the shortcode shown in the Shortcode meta box (e.g.
[event_calendar id="42"]) and paste it into any post, page, or text widget.
The shortcode is generated automatically based on the format you selected.
Saving
Click Publish or Update to save. The calendar is immediately available via its permalink and shortcode.