List Layout
The List format displays events as a sortable, paginated HTML table. Each row represents one event.
How It Looks
The table has a <thead> row with column labels and a <tbody> with one row per event. Alternate rows receive the class alternate for zebra striping.
The Date column is always present and always the first column. All other columns are optional and controlled by the Columns meta box on the calendar edit screen.
Available Columns
Which columns appear is set per-calendar in the Columns meta box. The available columns are:
Date — event date formatted according to Settings > General > Date Format (always shown)
Event / Teams / Home + Away — the event title, team names, or a split home/away layout; the exact label and structure depend on the Title Format setting in Events > Settings > Event List
Time/Results / Time / Results — kick-off time or scoreline; the column label depends on the Time/Results Format setting in Events > Settings > Event List
League — league taxonomy terms
Season — season taxonomy terms
Venue — venue taxonomy terms; venue names link to their archive pages when Link venues is enabled
Article — links to the event recap or preview; shows a camera icon if the event has a featured image and a video icon if a video is set
Match Day — the
sp_daymatch day value
Sorting
When the sortable option is enabled (controlled by the sortable shortcode parameter, defaulting to the Enable Sortable Tables site setting), the column headers become clickable sort controls powered by the SportsPress DataTables integration.
Pagination
When paginated is enabled (paginated="1", default), the table is broken into pages. The number of rows per page defaults to the Limit set in Events > Settings > Event List (default 10), and can be overridden with the rows shortcode parameter.
Responsive Mode
When responsive is enabled (responsive="1"), the table collapses on small screens, hiding lower-priority columns and showing them inline on row expansion. The number of visible rows in responsive mode is also controlled by rows.
Team Logos
Team logos appear next to team names when Display logos is enabled in Events > Settings > Event List or when show_team_logo="1" is passed to the shortcode.
Shortcode
[event_list id="42"]
Parameter | Default | Description |
| (empty) | Calendar post ID |
|
|
|
|
|
|
|
| Maximum events to show; |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Rows per page in paginated/responsive mode |
|
|
|
|
|
|
Difference from the Calendar Grid
The List layout presents events in a linear table rather than a monthly grid. It shows more detail per event (columns, results, venue, article links) and supports pagination and sorting. The Calendar grid is better for a monthly overview; the List is better for a detailed fixture/results schedule.