Timeline
The [sportspress_timeline] shortcode displays the match timeline for an event — a visual representation of key incidents (goals, cards, substitutions, etc.) plotted across the match duration.
Requires SportsPress Pro. The Timelines module must be enabled.
What It Displays
A horizontal or vertical timeline of match events. In horizontal format, incidents are plotted as markers along a progress bar spanning the full match duration, with icons and player names. In vertical format, incidents are listed in a table with columns for time, icon, player, and side (home/away).
The format used by the shortcode is controlled by the format parameter (default horizontal). The global site-default format is configured at Settings > Events > Timelines > Format, but the shortcode always defaults to horizontal regardless of the global setting unless you explicitly pass format="vertical".
When to Use It
Place on a single event page inside the Loop, or embed on any page with id. The shortcode reads the timeline data stored against the event post.
Parameters
Parameter | Type | Default | Description |
| integer |
| Post ID of the event. Required outside the Loop. |
| string |
| Timeline layout: |
Usage Examples
Inside the Loop on a single event page, horizontal (default):
[sportspress_timeline]
Vertical timeline embedded on any page:
[sportspress_timeline id="188" format="vertical"]
Horizontal timeline for a specific event:
[sportspress_timeline id="188"]
Note: The positional ID form is also supported:
[sportspress_timeline 188]
