Skip to Content
DocumentationSectionsCountdown

Countdown

Build promotional countdown layouts for product launches, sale windows, and limited-time offers. The section supplies the layout shell; the Countdown timer block owns the live timer.

Shopify theme editor showing the Fit Check Countdown section selected with a background image, launch copy, and countdown timer block.
Countdown sections can combine background containers, text, images, and the Countdown timer block in one promotional layout.

Configure the Section

  1. In the theme editor, click Add section.
  2. Select Countdown.
  3. Add text, image, or container blocks as needed.
  4. Add a Countdown timer block and set the target date.

Section Settings

SettingDescription
WidthChoose Page, Full screen, or Custom width. Custom width ranges from 60-100%.
HeightChoose Auto, Full screen, or Custom. Custom height uses Small, Medium, Large, or a custom percentage.
DirectionLay child blocks out vertically or horizontally. Default preset uses a vertical layout.
Vertical on mobileStack horizontal layouts on mobile.
AlignmentControl horizontal alignment for the active direction.
PositionControl vertical placement for the active direction.
GapSpace between child blocks. Range: 0-100px. Default: 12px.
Background colorOptional section background color. Leave Default to use the theme surface.
PaddingUse one all-sides value or separate Top, Bottom, Left, and Right values. Default: 32px unified; 0px left/right in split mode.

Blocks

The section accepts containers, container backgrounds, theme blocks, app blocks, and dividers. The default preset starts with a Container background that contains a Text block and a Countdown timer block.

Countdown Timer Block

The Countdown timer block counts down to a target date and can show days, hours, minutes, and seconds.

SettingDescription
Target dateDate and time in YYYY-MM-DDTHH:MM:SS format.
Days / Hours / Minutes / Seconds labelCustomize each timer unit label.
Expired textText shown when the timer reaches zero.
Show days / hours / minutes / secondsToggle individual timer units.
Numbers settingsControl number style, custom font, size, weight, color, background, padding, and radius.
Labels settingsControl label style, custom font, size, weight, color, and spacing.