Skip to main content

Countdown

The `[countdown]` shortcode displays a live countdown timer to the next upcoming event. It shows days, hours, minutes, and seconds remaining, updating in real time in the browser (when live mode is enabled).

Countdown

The [countdown] shortcode displays a live countdown timer to the next upcoming event. It shows days, hours, minutes, and seconds remaining, updating in real time in the browser (when live mode is enabled).
​

What It Displays

A countdown clock for the next scheduled event, along with the event title. Optionally shows team logos, the venue, the league, the season, the date, and the event thumbnail.
​

When to Use It

Use this shortcode on any page or widget where you want to build anticipation for the next match. An id is not required — by default the shortcode queries for the next future event site-wide. You can narrow results with team, league, season, or calendar.
​

Parameters

Parameter

Type

Default

Description

id

integer

null

Post ID of a specific event to count down to. When set, ignores all query filters.

calendar

integer

null

Post ID of a calendar. Uses the next future event from that calendar.

team

integer

null

Post ID of a team. Filters events to those involving that team.

league

integer/string

null

League term ID or slug. Filters events by league.

season

integer/string

null

Season term ID or slug. Filters events by season.

order

string

null

Sort order for the calendar query: ASC or DESC.

orderby

string

null

Field to order by when using a calendar.

title

string

null

Override the heading displayed above the countdown.

live

boolean

From settings

1 to animate the countdown in real time; 0 for static. Default follows the Enable live countdowns setting.

link_events

boolean

From settings

1 to link the event title to the event page.

link_teams

boolean

From settings

1 to link team logos to team pages.

link_venues

boolean

From settings

1 to link the venue name.

show_logos

boolean

From settings

1 to display team logos. Default follows the Show logos setting.

show_thumbnail

boolean

From settings

1 to display the event featured image.

Usage Examples

Minimal — next future event site-wide:
​

[countdown]

Next future event for a specific team, with logos displayed:
​

[countdown team="15" show_logos="1" link_teams="1"]

Count down to a specific calendar's next event:
​

[countdown calendar="28"]

Count down to one specific event by ID:
​

[countdown id="201"]

Did this answer your question?