Ctrlk
Get SAMITA
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Delivery variables

The seven tokens you can drop into a delivery message, and what each one renders.

A delivery message isn't fixed text. Anywhere you write one of these tokens, the app replaces it with a real value when the page loads — a calculated date, a live countdown, or the shopper's own country.

Open the Variables list from the message editor to insert one, or type it by hand — they're just text in curly braces.

The Variables panel listing the available delivery tokens with their descriptions
The Variables panel, opened from the delivery message editor.

The seven variables

Variable
Renders

{delivered_min_date}

The estimated order delivery minimum date

{delivered_max_date}

The estimated order delivery maximum date

{dispatched_min_date}

The estimated order dispatched minimum date

{dispatched_max_date}

The estimated order dispatched maximum date

{cutoff_time}

A live countdown to today's cut-off time

{country_flag}

The flag of the visitor's detected country

{country_name}

The name of the visitor's detected country

Dates

The four date variables come straight out of your date range settings, formatted with the Date format you chose there.

Pair the min and max of the same stage to express a window:

Use a single one when you want to sound definite rather than hedged:

The dispatch variables are the less useful pair for most stores — shoppers care when it lands, not when it leaves. They're worth showing if your dispatch speed is itself a selling point.

Cut-off countdown

{cutoff_time} renders as a running countdown to today's deadline, formatted with the Time format you chose. It's what makes a delivery message act like a countdown:

With the default 23:59 cut-off this reads as most of a day, which persuades nobody. Set a real cut-off before relying on it — see Cut-off time.

Country flag and name

{country_flag} renders a small flag image and {country_name} the country's name — both for the country the app detects for that visitor.

The country is detected from the visitor's IP address at the time they browse, not from an address on their account. Two consequences worth knowing:

  • A shopper on a VPN sees the country their VPN exits from.

  • The detection isn't infallible, so don't attach a promise to it that would be expensive to get wrong.

"Free shipping to {country_name}" is only true if it's true everywhere you sell. If your shipping rules vary by country, either soften the wording or use display conditions to show a different delivery message per country.

Writing a good message

The default message is a reasonable model: a shipping statement, then a deadline, then a window.

🚚 Free Shipping to {country_flag} {country_name} ✅ Order within the next {cutoff_time} for delivery between {delivered_min_date} - {delivered_max_date}

A few things that help:

  • Colour and bold the dates, not the whole sentence. The editor supports both.

  • Keep it to two lines. It sits near the Add to cart button, where it competes for attention.

  • Check it on mobile. A message that reads well on desktop can wrap badly on a phone.

Next steps

PreviousCut-off time
NextStock countdown overview

Last updated

Was this helpful?