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 |
| integer |
| Post ID of a specific event to count down to. When set, ignores all query filters. |
| integer |
| Post ID of a calendar. Uses the next future event from that calendar. |
| integer |
| Post ID of a team. Filters events to those involving that team. |
| integer/string |
| League term ID or slug. Filters events by league. |
| integer/string |
| Season term ID or slug. Filters events by season. |
| string |
| Sort order for the calendar query: |
| string |
| Field to order by when using a calendar. |
| string |
| Override the heading displayed above the countdown. |
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
| boolean | From settings |
|
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"]
