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).

Updated today

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?