SScale Themedocs

Display a dynamic delivery estimate on the product page with countdown and automatically calculated dates.

Delivery Estimation

The Delivery Estimation block displays an estimated delivery date directly on the product page. It automatically calculates dates based on the cutoff time, shipping delay, and business days.

How to Add It

  1. Open the Shopify theme editor
  2. Navigate to a product page
  3. Click Add a block in the product section
  4. Select Delivery Estimation
ℹ️This block is limited to 1 per section. A dedicated JavaScript file (js-delivery-estimation.js) handles the dynamic date calculation and countdown.

2 Display Formats

The block offers two radically different display modes:

FormatDescriptionIdeal For
Visual (timeline)Two columns with icons: countdown + shipping dateMaximum impact, premium product pages
TextCompact message with icon, countdown, and date inlineDiscreet display, integration into the product flow

Visual format

The visual format displays a timeline in two columns:

  • Left column: Clock icon + "Order within" label + real-time countdown
  • Separator: Progress arrow
  • Right column: Calendar icon + "Ships" label + calculated day

Text format

The text format displays a compact message with dynamic placeholders:

PlaceholderReplaced ByExample
{countdown}Time remaining before cutoff2h 34min
{date}Estimated shipping date (fixed mode)Wednesday, February 26
{date_min}Minimum date (range mode)Tuesday, February 25
{date_max}Maximum date (range mode)Friday, February 28

Settings

Visual Format Labels

These settings are visible only when the Visual format is selected:

SettingDefaultDescription
Cutoff label"Order within"Text above the countdown
Shipping label"Ships"Text above the date
Cutoff passed label"Order today"Text when the cutoff time has passed

Text Format Messages

These settings are visible only when the Text format is selected:

SettingDefaultDescription
Enable cutoffYesDisplays the message with countdown
Cutoff message"Order within {countdown} for same-day dispatch!"Message with the countdown
Cutoff colorAccent 1Cutoff text color
Delivery message (fixed)"Get it by {date}"Message with fixed date
Delivery message (range)"Arrives {date_min} - {date_max}"Message with date range

Cutoff Time

SettingTypeRangeDefaultDescription
HourRange0-2314Cutoff hour for same-day shipping
MinuteRange0-590Cutoff minute
💡Set the cutoff time to the actual time when you stop preparing orders. For example, if your warehouse stops order preparation at 2 PM, set it to 14:00. This creates authentic urgency: "Order before 2 PM for same-day shipping."

Delivery Delay

SettingTypeRangeDefaultDescription
TypeSelectFixed / RangeFixedDelay calculation mode
Days (fixed)Range1-303Number of delivery days
Minimum daysRange1-302Range minimum
Maximum daysRange1-305Range maximum
Exclude weekendsCheckbox-YesOnly counts business days
⚠️If you enable Exclude weekends, Saturdays and Sundays are not counted in the delay. An order placed on Friday with a 3-day delay will show Wednesday (not Monday).

Style

SettingTypeOptionsDefaultDescription
StyleSelectFilled / Outline / MinimalFilledContainer appearance
Color paletteColor scheme-Background 2Block colors (except minimal)
Border radiusRange0-20px8pxCorner rounding (except minimal)
IconSelectIcon listlocal_shippingDisplayed icon (text format)
Custom iconImage picker--Image to use as icon (text format)

How the Calculation Works

The JavaScript script automatically calculates dates using this logic:

  1. Cutoff time check: If the current time is before the cutoff, the countdown shows the remaining time. Otherwise, the starting day shifts to tomorrow.
  2. Delay calculation: From the starting day, the script adds the configured number of days.
  3. Weekend exclusion: If enabled, Saturdays and Sundays are skipped in the calculation.
  4. Localization: Dates are formatted in the visitor's language (via request.locale.iso_code).

Use Cases

Standard e-commerce

  • Visual format, filled style
  • Cutoff at 2 PM, 3 fixed days delay, weekends excluded
  • Creates urgency with the real-time countdown

Products with variable delivery

  • Text format, range type
  • Min 2 days, max 5 days delay
  • Message: "Arrives {date_min} - {date_max}"

Dropshipping / long delays

  • Text format, 7-14 day delay
  • Disable the cutoff to avoid creating false urgency
  • Simple message with the date range
💡The visual format with its real-time countdown is the most effective for conversion. The ticking countdown creates a natural sense of urgency that drives immediate purchase.