Skip to main content

Scoreboard Layout

The **Scoreboard** format is a Pro feature added by the SportsPress Scoreboard module. It displays events in a horizontally scrolling ticker strip, similar to sports broadcast scoreboards.

Scoreboard Layout

The Scoreboard format is a Pro feature added by the SportsPress Scoreboard module. It displays events in a horizontally scrolling ticker strip, similar to sports broadcast scoreboards.
​

This feature is part of SportsPress Pro.
​

How It Looks

Events are laid out side by side in a single horizontal row inside a fixed-width viewport. Left and right arrow buttons scroll the strip forward and backward by a configurable number of events at a time. Each event card shows the competing teams (with optional logos) and the result or kick-off time. Clicking an event card navigates to the event page.
​

Optional metadata — date, time, league, season, and venue — can be shown above the team names inside each card.
​

The event whose page is currently being viewed receives the CSS class sp-highlight on its card.
​

Scoreboard Settings

Global scoreboard settings live at Events > Settings, under the Scoreboard section. Each setting has a corresponding shortcode parameter that overrides it per-instance.
​

Details

Details controls which metadata lines appear inside each event card:
​

  • Date (sportspress_scoreboard_show_date, default: off) — show the event date

  • Time (sportspress_scoreboard_show_time, default: on) — show the kick-off time or result time

  • League (sportspress_scoreboard_show_league, default: off) — show the event's league

  • Season (sportspress_scoreboard_show_season, default: off) — show the event's season

  • Venue (sportspress_scoreboard_show_venue, default: off) — show the event's venue

Date Format

Date Format (sportspress_scoreboard_date_format, default: M j) — PHP date format string used to format the date when Date is enabled. For example, M j produces "Apr 25".
​

Teams

Display logos (sportspress_scoreboard_show_logos, default: off) — show team logo images (featured images) alongside team names inside each card.
​

Display

Display (sportspress_scoreboard_limit, default: 0) — maximum number of events to show in the scoreboard. 0 means no limit. This setting also controls how many events appear in the site header scoreboard (if the header feature is active).
​

Width

Width (sportspress_scoreboard_width, default: 180) — width of each event card in pixels. Minimum value: 50.
​

Scroll

Scroll (sportspress_scoreboard_step, default: 2) — number of events the strip advances with each arrow button click. The pixel distance scrolled equals Width × Scroll.
​

Event Selection

When used without an id, the scoreboard automatically shows a mix of the most recent past events and the nearest upcoming events, centered on today. When an id is provided, the scoreboard uses that calendar's filter settings.
​

Header Scoreboard

When Display is set to a non-zero value, the scoreboard also appears automatically in the site header (inside the sportspress_header action hook). This is independent of any calendar post; it queries events globally using the limit value. Themes that declare add_theme_support( 'sportspress' ) suppress this behavior.
​

Shortcode

[event_scoreboard id="42"]

The id parameter is optional. Omitting it renders a global scoreboard using the limit and settings from the Scoreboard section of Event Settings.
​

Parameter

Default (setting key)

Description

id

(empty)

Calendar post ID

status

default

default, publish, or future

date

default

Date filter value

number

-1

Maximum events; overrides the Display setting when provided

width

sportspress_scoreboard_width

Card width in pixels

step

sportspress_scoreboard_step

Events to scroll per click

show_team_logo

sportspress_scoreboard_show_logos

true/false

show_date

sportspress_scoreboard_show_date

true/false

show_time

sportspress_scoreboard_show_time

true/false

show_league

sportspress_scoreboard_show_league

true/false

show_season

sportspress_scoreboard_show_season

true/false

show_venue

sportspress_scoreboard_show_venue

true/false

date_format

sportspress_scoreboard_date_format

PHP date format string

order

default

ASC or DESC

show_all_events_link

false

true to show a View all events link

Did this answer your question?