{"id":44611,"date":"2026-06-08T13:55:00","date_gmt":"2026-06-08T13:55:00","guid":{"rendered":"https:\/\/getshortcodes.com\/?post_type=docs&#038;p=44611"},"modified":"2026-06-08T17:55:40","modified_gmt":"2026-06-08T17:55:40","slug":"countdown-timer","status":"publish","type":"docs","link":"https:\/\/getshortcodes.com\/docs\/countdown-timer\/","title":{"rendered":"Countdown Timer"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Countdown Timer is a <a href=\"\/pricing\/\">Shortcodes Ultimate Pro<\/a> 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.<\/p>\n\n\n\n<h2 id=\"features-overview\" class=\"wp-block-heading\">Features Overview<\/h2>\n\n\n\n<figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Countdown Timer Shortcode Features Overview\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/q38ZJGbvFoQ?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n\n\n<div class=\"wp-block-group has-black-color has-light-background-color has-text-color has-background has-link-color wp-elements-f30dca526f35543ec2aba04b40908c87 is-content-justification-space-between is-nowrap is-layout-flex wp-container-core-group-is-layout-b0ffac9c wp-block-group-is-layout-flex\">\n<p class=\"has-text-align-center wp-block-paragraph\" style=\"font-style:normal;font-weight:600\">This shortcode is available in Shortcodes Ultimate Pro<\/p>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button is-style-primary\"><a class=\"wp-block-button__link wp-element-button\" href=\"\/pricing\/\"><strong>Learn More \u2192<\/strong><\/a><\/div>\n<\/div>\n<\/div>\n\n\n\n<h2 id=\"parameters\" class=\"wp-block-heading\">Parameters<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Parameter<\/th><th>Default value<\/th><th>Description<\/th><th>Possible values<\/th><\/tr><\/thead><tbody><tr><td><code>end_date<\/code><\/td><td><code>2099-12-31<\/code><\/td><td>Countdown end date in the site timezone.<\/td><td>Date in one of these formats: <code>Y-m-d<\/code>, <code>d-M-Y<\/code>, <code>j-M-Y<\/code>, <code>d M Y<\/code>, <code>j M Y<\/code>, <code>d-m-Y<\/code>, <code>j-m-Y<\/code>, <code>m\/d\/Y<\/code>, <code>m-d-Y<\/code>. Empty or invalid values fall back to <code>2099-12-31<\/code>.<\/td><\/tr><tr><td><code>end_time<\/code><\/td><td><code>00:00<\/code><\/td><td>Countdown end time in the site timezone.<\/td><td>Time in <code>HH:MM<\/code> or <code>HH:MM:SS<\/code> format. Hours: <code>0<\/code>&#8211;<code>23<\/code>; minutes and seconds: <code>0<\/code>&#8211;<code>59<\/code>. The sanitized value is normalized to <code>HH:MM:SS<\/code>; empty or invalid values fall back to <code>00:00:00<\/code>.<\/td><\/tr><tr><td><code>expired_text<\/code><\/td><td><code>Time is up<\/code><\/td><td>Text shown when the countdown has expired.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>.<\/td><\/tr><tr><td><code>after_expiration<\/code><\/td><td><code>show_empty_text<\/code><\/td><td>Choose what to show when the countdown has expired.<\/td><td><code>show_empty_text<\/code> &#8211; show expired text; <code>show_zeros<\/code> &#8211; show zero values; <code>hide<\/code> &#8211; hide the countdown.<\/td><\/tr><tr><td><code>expired_text_color<\/code><\/td><td><code>#333333<\/code><\/td><td>Color of the text shown when the countdown has expired.<\/td><td>Empty value, <code>transparent<\/code>, hex color such as <code>#333333<\/code>, <code>rgb(r,g,b)<\/code>, or <code>rgba(r,g,b,a)<\/code>. RGB channels are clamped to <code>0<\/code>&#8211;<code>255<\/code>; alpha is clamped to <code>0<\/code>&#8211;<code>1<\/code>. Invalid values become empty after sanitization.<\/td><\/tr><tr><td><code>expired_text_size<\/code><\/td><td><code>14<\/code><\/td><td>Expired text size in pixels. Set to <code>0<\/code> to use the default size.<\/td><td>Integer from <code>0<\/code> to <code>120<\/code>. Non-numeric values fall back to <code>14<\/code>.<\/td><\/tr><tr><td><code>show_separators<\/code><\/td><td><code>yes<\/code><\/td><td>Show separators between countdown units.<\/td><td>Boolean-like values: <code>yes<\/code>, <code>true<\/code>, <code>1<\/code>, <code>on<\/code> become <code>yes<\/code>; <code>no<\/code>, <code>false<\/code>, <code>0<\/code>, <code>off<\/code> become <code>no<\/code>. Invalid values fall back to <code>yes<\/code>.<\/td><\/tr><tr><td><code>separator<\/code><\/td><td><code>:<\/code><\/td><td>Text between countdown units.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>. Empty value is allowed and disables visible separators.<\/td><\/tr><tr><td><code>separator_color<\/code><\/td><td><code>#333333<\/code><\/td><td>Color of countdown separators.<\/td><td><code>transparent<\/code>, hex color such as <code>#333333<\/code>, <code>rgb(r,g,b)<\/code>, or <code>rgba(r,g,b,a)<\/code>. Invalid values fall back to <code>#333333<\/code>.<\/td><\/tr><tr><td><code>separator_animation<\/code><\/td><td><code>yes<\/code><\/td><td>Enable separator blinking animation.<\/td><td>Boolean-like values: <code>yes<\/code>, <code>true<\/code>, <code>1<\/code>, <code>on<\/code> become <code>yes<\/code>; <code>no<\/code>, <code>false<\/code>, <code>0<\/code>, <code>off<\/code> become <code>no<\/code>. Invalid values fall back to <code>yes<\/code>.<\/td><\/tr><tr><td><code>align<\/code><\/td><td><code>center<\/code><\/td><td>Countdown container alignment.<\/td><td><code>left<\/code>, <code>center<\/code>, <code>right<\/code>. Invalid values fall back to <code>center<\/code>.<\/td><\/tr><tr><td><code>horizontal_spacing<\/code><\/td><td><code>20<\/code><\/td><td>Spacing between digit blocks and separators in pixels.<\/td><td>Integer from <code>0<\/code> to <code>100<\/code>. Non-numeric values fall back to <code>20<\/code>.<\/td><\/tr><tr><td><code>vertical_spacing<\/code><\/td><td><code>10<\/code><\/td><td>Spacing between digits and labels in pixels.<\/td><td>Integer from <code>0<\/code> to <code>100<\/code>. Non-numeric values fall back to <code>10<\/code>.<\/td><\/tr><tr><td><code>container_background_color<\/code><\/td><td><code>transparent<\/code><\/td><td>Background color of the countdown container.<\/td><td><code>transparent<\/code>, hex color such as <code>#333333<\/code>, <code>rgb(r,g,b)<\/code>, or <code>rgba(r,g,b,a)<\/code>. Invalid values fall back to <code>transparent<\/code>.<\/td><\/tr><tr><td><code>container_border<\/code><\/td><td><code>0px solid #CCCCCC<\/code><\/td><td>Border around the countdown container.<\/td><td>Border string in the form <code>WIDTHpx STYLE COLOR<\/code>; <code>px<\/code> after width is optional. Width is clamped to <code>0<\/code>&#8211;<code>15<\/code>. Style: <code>solid<\/code>, <code>dotted<\/code>, <code>dashed<\/code>, <code>double<\/code>, <code>groove<\/code>, <code>ridge<\/code>. Color accepts the same formats as color parameters. Invalid parts fall back to values from <code>0px solid #CCCCCC<\/code>.<\/td><\/tr><tr><td><code>container_border_radius<\/code><\/td><td><code>10<\/code><\/td><td>Container border radius in pixels.<\/td><td>Integer from <code>0<\/code> to <code>100<\/code>. Non-numeric values fall back to <code>10<\/code>.<\/td><\/tr><tr><td><code>container_padding<\/code><\/td><td><code>10<\/code><\/td><td>Inner container padding in pixels.<\/td><td>Integer from <code>0<\/code> to <code>100<\/code>. Non-numeric values fall back to <code>10<\/code>.<\/td><\/tr><tr><td><code>show_years<\/code><\/td><td><code>yes<\/code><\/td><td>Show the <code>years<\/code> unit.<\/td><td>Boolean-like values: <code>yes<\/code>, <code>true<\/code>, <code>1<\/code>, <code>on<\/code> become <code>yes<\/code>; <code>no<\/code>, <code>false<\/code>, <code>0<\/code>, <code>off<\/code> become <code>no<\/code>. Invalid values fall back to <code>yes<\/code>.<\/td><\/tr><tr><td><code>show_months<\/code><\/td><td><code>yes<\/code><\/td><td>Show the <code>months<\/code> unit.<\/td><td>Boolean-like values: <code>yes<\/code>, <code>true<\/code>, <code>1<\/code>, <code>on<\/code> become <code>yes<\/code>; <code>no<\/code>, <code>false<\/code>, <code>0<\/code>, <code>off<\/code> become <code>no<\/code>. Invalid values fall back to <code>yes<\/code>.<\/td><\/tr><tr><td><code>show_days<\/code><\/td><td><code>yes<\/code><\/td><td>Show the <code>days<\/code> unit.<\/td><td>Boolean-like values: <code>yes<\/code>, <code>true<\/code>, <code>1<\/code>, <code>on<\/code> become <code>yes<\/code>; <code>no<\/code>, <code>false<\/code>, <code>0<\/code>, <code>off<\/code> become <code>no<\/code>. Invalid values fall back to <code>yes<\/code>.<\/td><\/tr><tr><td><code>show_hours<\/code><\/td><td><code>yes<\/code><\/td><td>Show the <code>hours<\/code> unit.<\/td><td>Boolean-like values: <code>yes<\/code>, <code>true<\/code>, <code>1<\/code>, <code>on<\/code> become <code>yes<\/code>; <code>no<\/code>, <code>false<\/code>, <code>0<\/code>, <code>off<\/code> become <code>no<\/code>. Invalid values fall back to <code>yes<\/code>.<\/td><\/tr><tr><td><code>years_label<\/code><\/td><td><code>YEARS<\/code><\/td><td>Label shown under or next to years.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>.<\/td><\/tr><tr><td><code>months_label<\/code><\/td><td><code>MONTHS<\/code><\/td><td>Label shown under or next to months.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>.<\/td><\/tr><tr><td><code>days_label<\/code><\/td><td><code>DAYS<\/code><\/td><td>Label shown under or next to days.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>.<\/td><\/tr><tr><td><code>hours_label<\/code><\/td><td><code>HOURS<\/code><\/td><td>Label shown under or next to hours.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>.<\/td><\/tr><tr><td><code>minutes_label<\/code><\/td><td><code>MINUTES<\/code><\/td><td>Label shown under or next to minutes.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>. The <code>minutes<\/code> unit is always shown.<\/td><\/tr><tr><td><code>seconds_label<\/code><\/td><td><code>SECONDS<\/code><\/td><td>Label shown under or next to seconds.<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>. The <code>seconds<\/code> unit is always shown.<\/td><\/tr><tr><td><code>label_position<\/code><\/td><td><code>bottom<\/code><\/td><td>Position of labels relative to digits.<\/td><td><code>bottom<\/code>, <code>right<\/code>, <code>right_bottom<\/code>. Invalid values fall back to <code>bottom<\/code>.<\/td><\/tr><tr><td><code>digit_background_color<\/code><\/td><td><code>transparent<\/code><\/td><td>Background color of digit blocks.<\/td><td><code>transparent<\/code>, hex color such as <code>#333333<\/code>, <code>rgb(r,g,b)<\/code>, or <code>rgba(r,g,b,a)<\/code>. Invalid values fall back to <code>transparent<\/code>.<\/td><\/tr><tr><td><code>digit_border<\/code><\/td><td><code>0px solid #CCCCCC<\/code><\/td><td>Border around digit blocks.<\/td><td>Border string in the form <code>WIDTHpx STYLE COLOR<\/code>; <code>px<\/code> after width is optional. Width is clamped to <code>0<\/code>&#8211;<code>15<\/code>. Style: <code>solid<\/code>, <code>dotted<\/code>, <code>dashed<\/code>, <code>double<\/code>, <code>groove<\/code>, <code>ridge<\/code>. Color accepts the same formats as color parameters. Invalid parts fall back to values from <code>0px solid #CCCCCC<\/code>.<\/td><\/tr><tr><td><code>digit_color<\/code><\/td><td><code>#333333<\/code><\/td><td>Color of countdown digits.<\/td><td><code>transparent<\/code>, hex color such as <code>#333333<\/code>, <code>rgb(r,g,b)<\/code>, or <code>rgba(r,g,b,a)<\/code>. Invalid values fall back to <code>#333333<\/code>.<\/td><\/tr><tr><td><code>label_color<\/code><\/td><td><code>#aaaaaa<\/code><\/td><td>Color of countdown labels.<\/td><td><code>transparent<\/code>, hex color such as <code>#aaaaaa<\/code>, <code>rgb(r,g,b)<\/code>, or <code>rgba(r,g,b,a)<\/code>. Invalid values fall back to <code>#aaaaaa<\/code>.<\/td><\/tr><tr><td><code>digits_text_size<\/code><\/td><td><code>0<\/code><\/td><td>Countdown digits text size in pixels. Set to <code>0<\/code> to use the default size.<\/td><td>Integer from <code>0<\/code> to <code>120<\/code>. Non-numeric values fall back to <code>0<\/code>.<\/td><\/tr><tr><td><code>labels_text_size<\/code><\/td><td><code>0<\/code><\/td><td>Countdown labels text size in pixels. Set to <code>0<\/code> to use the default size.<\/td><td>Integer from <code>0<\/code> to <code>120<\/code>. Non-numeric values fall back to <code>0<\/code>.<\/td><\/tr><tr><td><code>digit_border_radius<\/code><\/td><td><code>10<\/code><\/td><td>Digit block border radius in pixels.<\/td><td>Integer from <code>0<\/code> to <code>1000<\/code>. Non-numeric values fall back to <code>10<\/code>.<\/td><\/tr><tr><td><code>digit_padding<\/code><\/td><td><code>10<\/code><\/td><td>Inner digit block padding in pixels.<\/td><td>Integer from <code>0<\/code> to <code>100<\/code>. Non-numeric values fall back to <code>10<\/code>.<\/td><\/tr><tr><td><code>digit_animation<\/code><\/td><td><code>opacity<\/code><\/td><td>Animation used when digit values change.<\/td><td><code>disabled<\/code>, <code>flip<\/code>, <code>opacity<\/code>. Invalid values fall back to <code>opacity<\/code>.<\/td><\/tr><tr><td><code>class<\/code><\/td><td>Empty string<\/td><td>Additional CSS class name(s) separated by space(s).<\/td><td>Any plain text accepted by <code>sanitize_text_field()<\/code>, typically one or more CSS class names separated by spaces.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\"><\/p>\n","protected":false},"featured_media":0,"template":"","docs_category":[21],"class_list":["post-44611","docs","type-docs","status-publish","hentry","docs_category-shortcodes"],"acf":[],"_links":{"self":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs\/44611","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/types\/docs"}],"wp:attachment":[{"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/media?parent=44611"}],"wp:term":[{"taxonomy":"docs_category","embeddable":true,"href":"https:\/\/getshortcodes.com\/api\/wp\/v2\/docs_category?post=44611"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}