Skip to main content

Event Scoreboard

The `[event_scoreboard]` shortcode displays a horizontally scrolling ticker-style scoreboard showing events with team names and scores or scheduled times. Each event card has a fixed width and users can scroll left/right through the events.

Updated today

Event Scoreboard

The [event_scoreboard] shortcode displays a horizontally scrolling ticker-style scoreboard showing events with team names and scores or scheduled times. Each event card has a fixed width and users can scroll left/right through the events.

Requires SportsPress Pro. The Scoreboard module must be enabled (Settings > Events > Scoreboard).

What It Displays

A scrollable row of event cards. Each card shows optional date, time, league, season, and venue metadata at the top, followed by team names (with optional logos) and their scores or scheduled time. Scroll buttons on each side let users page through the events.

When to Use It

Use on any page, post, or widget. It can also be placed site-wide via the Header Scoreboard setting (the header scoreboard uses the global limit setting). With id it filters to a specific Calendar; without id it queries all events.

Parameters

Parameter

Type

Default

Description

id

integer

null

Post ID of the SportsPress Calendar to display.

status

string

'default'

Event status filter: 'default', 'future', 'publish'.

date

string

'default'

Date preset. When id is not set, defaults to 'auto' (past and future around today).

date_from

string

'default'

Start of date range (YYYY-MM-DD).

date_to

string

'default'

End of date range (YYYY-MM-DD).

date_past

string

'default'

Days in the past to include.

date_future

string

'default'

Days in the future to include.

date_relative

string

'default'

Relative date mode.

day

string

'default'

Match day filter.

league

integer/string

null

League term ID or slug.

season

integer/string

null

Season term ID or slug.

date_format

string

From settings

PHP date format for the date display. Default from Scoreboard > Date Format setting (M j).

number

integer

-1

Maximum number of events to display. -1 shows all.

width

integer

From settings

Width in pixels of each event card. Default from Scoreboard > Width setting (180).

step

integer

From settings

Number of events to scroll per click. Default from Scoreboard > Scroll setting (2).

show_team_logo

boolean

From settings

1 to show team logos. Default from Scoreboard > Display logos setting.

link_events

boolean

From settings

1 to link event cards to event pages.

order

string

'default'

Sort order: 'ASC' or 'DESC'.

show_all_events_link

boolean

false

1 to show a "View all events" link (requires id).

show_date

boolean

From settings

1 to show the event date in each card.

show_time

boolean

From settings

1 to show the event time in each card. Default true.

show_league

boolean

From settings

1 to show the league in each card.

show_season

boolean

From settings

1 to show the season in each card.

show_venue

boolean

From settings

1 to show the venue in each card.

Usage Examples

Minimal — scoreboard from a specific calendar:

[event_scoreboard id="30"]

Scoreboard for all events in a league, with logos and time shown, scrolling 3 at a time:

[event_scoreboard league="5" show_team_logo="1" show_time="1" step="3"]

Scoreboard showing the 10 most recent or upcoming events, with date and no time:

[event_scoreboard number="10" show_date="1" show_time="0"]

Did this answer your question?