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 |
| integer |
| Post ID of the SportsPress Calendar to display. |
| string |
| Event status filter: |
| string |
| Date preset. When |
| string |
| Start of date range (YYYY-MM-DD). |
| string |
| End of date range (YYYY-MM-DD). |
| string |
| Days in the past to include. |
| string |
| Days in the future to include. |
| string |
| Relative date mode. |
| string |
| Match day filter. |
| integer/string |
| League term ID or slug. |
| integer/string |
| Season term ID or slug. |
| string | From settings | PHP date format for the date display. Default from Scoreboard > Date Format setting ( |
| integer |
| Maximum number of events to display. |
| integer | From settings | Width in pixels of each event card. Default from Scoreboard > Width setting ( |
| integer | From settings | Number of events to scroll per click. Default from Scoreboard > Scroll setting ( |
| boolean | From settings |
|
| boolean | From settings |
|
| string |
| Sort order: |
| boolean |
|
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
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"]
