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.

Updated today

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?