Countdown Timer

View Examples

Countdown Timer is a Shortcodes Ultimate Pro shortcode for creating high-impact launch, sale, event, and deadline timers. It helps draw attention to time-sensitive offers with animated digits, flexible date and time settings, customizable labels, separators, colors, spacing, and clear post-expiration behavior.

Features Overview

Parameters

Parameter	Default value	Description	Possible values
end_date	2099-12-31	Countdown end date in the site timezone.	Date in one of these formats: Y-m-d, d-M-Y, j-M-Y, d M Y, j M Y, d-m-Y, j-m-Y, m/d/Y, m-d-Y. Empty or invalid values fall back to 2099-12-31.
end_time	00:00	Countdown end time in the site timezone.	Time in HH:MM or HH:MM:SS format. Hours: 0–23; minutes and seconds: 0–59. The sanitized value is normalized to HH:MM:SS; empty or invalid values fall back to 00:00:00.
expired_text	Time is up	Text shown when the countdown has expired.	Any plain text accepted by sanitize_text_field().
after_expiration	show_empty_text	Choose what to show when the countdown has expired.	show_empty_text – show expired text; show_zeros – show zero values; hide – hide the countdown.
expired_text_color	#333333	Color of the text shown when the countdown has expired.	Empty value, transparent, hex color such as #333333, rgb(r,g,b), or rgba(r,g,b,a). RGB channels are clamped to 0–255; alpha is clamped to 0–1. Invalid values become empty after sanitization.
expired_text_size	14	Expired text size in pixels. Set to 0 to use the default size.	Integer from 0 to 120. Non-numeric values fall back to 14.
show_separators	yes	Show separators between countdown units.	Boolean-like values: yes, true, 1, on become yes; no, false, 0, off become no. Invalid values fall back to yes.
separator	:	Text between countdown units.	Any plain text accepted by sanitize_text_field(). Empty value is allowed and disables visible separators.
separator_color	#333333	Color of countdown separators.	transparent, hex color such as #333333, rgb(r,g,b), or rgba(r,g,b,a). Invalid values fall back to #333333.
separator_animation	yes	Enable separator blinking animation.	Boolean-like values: yes, true, 1, on become yes; no, false, 0, off become no. Invalid values fall back to yes.
align	center	Countdown container alignment.	left, center, right. Invalid values fall back to center.
horizontal_spacing	20	Spacing between digit blocks and separators in pixels.	Integer from 0 to 100. Non-numeric values fall back to 20.
vertical_spacing	10	Spacing between digits and labels in pixels.	Integer from 0 to 100. Non-numeric values fall back to 10.
container_background_color	transparent	Background color of the countdown container.	transparent, hex color such as #333333, rgb(r,g,b), or rgba(r,g,b,a). Invalid values fall back to transparent.
container_border	0px solid #CCCCCC	Border around the countdown container.	Border string in the form WIDTHpx STYLE COLOR; px after width is optional. Width is clamped to 0–15. Style: solid, dotted, dashed, double, groove, ridge. Color accepts the same formats as color parameters. Invalid parts fall back to values from 0px solid #CCCCCC.
container_border_radius	10	Container border radius in pixels.	Integer from 0 to 100. Non-numeric values fall back to 10.
container_padding	10	Inner container padding in pixels.	Integer from 0 to 100. Non-numeric values fall back to 10.
show_years	yes	Show the years unit.	Boolean-like values: yes, true, 1, on become yes; no, false, 0, off become no. Invalid values fall back to yes.
show_months	yes	Show the months unit.	Boolean-like values: yes, true, 1, on become yes; no, false, 0, off become no. Invalid values fall back to yes.
show_days	yes	Show the days unit.	Boolean-like values: yes, true, 1, on become yes; no, false, 0, off become no. Invalid values fall back to yes.
show_hours	yes	Show the hours unit.	Boolean-like values: yes, true, 1, on become yes; no, false, 0, off become no. Invalid values fall back to yes.
years_label	YEARS	Label shown under or next to years.	Any plain text accepted by sanitize_text_field().
months_label	MONTHS	Label shown under or next to months.	Any plain text accepted by sanitize_text_field().
days_label	DAYS	Label shown under or next to days.	Any plain text accepted by sanitize_text_field().
hours_label	HOURS	Label shown under or next to hours.	Any plain text accepted by sanitize_text_field().
minutes_label	MINUTES	Label shown under or next to minutes.	Any plain text accepted by sanitize_text_field(). The minutes unit is always shown.
seconds_label	SECONDS	Label shown under or next to seconds.	Any plain text accepted by sanitize_text_field(). The seconds unit is always shown.
label_position	bottom	Position of labels relative to digits.	bottom, right, right_bottom. Invalid values fall back to bottom.
digit_background_color	transparent	Background color of digit blocks.	transparent, hex color such as #333333, rgb(r,g,b), or rgba(r,g,b,a). Invalid values fall back to transparent.
digit_border	0px solid #CCCCCC	Border around digit blocks.	Border string in the form WIDTHpx STYLE COLOR; px after width is optional. Width is clamped to 0–15. Style: solid, dotted, dashed, double, groove, ridge. Color accepts the same formats as color parameters. Invalid parts fall back to values from 0px solid #CCCCCC.
digit_color	#333333	Color of countdown digits.	transparent, hex color such as #333333, rgb(r,g,b), or rgba(r,g,b,a). Invalid values fall back to #333333.
label_color	#aaaaaa	Color of countdown labels.	transparent, hex color such as #aaaaaa, rgb(r,g,b), or rgba(r,g,b,a). Invalid values fall back to #aaaaaa.
digits_text_size	0	Countdown digits text size in pixels. Set to 0 to use the default size.	Integer from 0 to 120. Non-numeric values fall back to 0.
labels_text_size	0	Countdown labels text size in pixels. Set to 0 to use the default size.	Integer from 0 to 120. Non-numeric values fall back to 0.
digit_border_radius	10	Digit block border radius in pixels.	Integer from 0 to 1000. Non-numeric values fall back to 10.
digit_padding	10	Inner digit block padding in pixels.	Integer from 0 to 100. Non-numeric values fall back to 10.
digit_animation	opacity	Animation used when digit values change.	disabled, flip, opacity. Invalid values fall back to opacity.
class	Empty string	Additional CSS class name(s) separated by space(s).	Any plain text accepted by sanitize_text_field(), typically one or more CSS class names separated by spaces.