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.

Updated today

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?