Skip to main content

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.

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

id

integer

get_the_ID()

Post ID of the event. Required outside the Loop.

format

string

'horizontal'

Timeline layout: 'horizontal' for the progress-bar style, 'vertical' for the table-row style.

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]

Did this answer your question?