Cutoff times

The cutoff time is the deadline after which an order placed today counts as tomorrow’s order. It’s the single most-watched number in the widget — the live clock counts down to it on every product page.

How the cutoff is applied

Conceptually, the plugin’s “today” for shipping-date math is not the same as the wall-clock today:

if  now <= cutoff_today AND today is a working day AND today is not a holiday
    effective_today = today
else
    effective_today = next working day that isn't a holiday

The shipping minimum date is then effective_today + shippingMinDays, and the rest of the dates follow.

General vs. per-weekday cutoff

On the Settings → Cutoff time card:

• General cutoff time (cutoffTime) — the default cutoff used when a weekday-specific one isn’t set.
• Monday … Sunday cutoff time — overrides for individual days. Leave empty to inherit the general value.

If you set the Friday cutoff to 12:00 while the general cutoff is 15:00:

• Mon–Thu — orders ship today if placed before 15:00.
• Friday — orders ship today only if placed before 12:00 (courier picks up earlier on Fridays).
• Sat/Sun — typically inherit the general 15:00 cutoff, but because the working-days rule usually excludes weekends, the order rolls over anyway.

Cutoff time format

The widget shows the remaining time to the cutoff using one of two formats:

cutoffTimeFormat	Renders as
%hours% %transHours% %minutes% %transMinutes% %seconds% %transSeconds%	02 hours 14 minutes 32 seconds
%hours% %transHours% %minutes% %transMinutes%	02 hours 14 minutes

The unit labels (%transHours%, %transMinutes%, %transSeconds%) come from the Translation tab and auto-pluralise (hour vs hours, etc.). To enforce bold typography on the numbers or labels, use the Bold numbers and Bold texts toggles in the same card.

Setting “no shipping today”

Two options:

1. Leave that weekday’s cutoff empty — the plugin treats it as “no cutoff”, and the working-days rule decides what happens. If that weekday is also missing from the working-days rule, the order rolls to the next working day.
2. Set the cutoff to 00:00 — same effect: no order placed during the day can beat the cutoff, so everything rolls over.

Either approach is fine — option (1) is cleaner because it doesn’t require a fictional cutoff value.

Cutoff vs. holidays

The cutoff time always applies to the wall-clock day, not the effective shipping day. If today is Monday but Monday is a holiday, the cutoff for Monday is ignored entirely — the plugin already knows nothing ships today and rolls over.

Cutoff and the Clock widget

The Clock widget reads the cutoff three ways:

• Before today’s cutoff has passed → counts down to today’s cutoff, shows “today” as the dispatch label.
• After today’s cutoff (but the day is still a working day) → counts down to the next working day’s cutoff.
• On a non-working day → same as above.

If the next working day is more than one day away (e.g. ordering Saturday for Monday dispatch), the clock uses the alternative clockOrderInTheNextWithDays snippet which includes a day counter (“Order in the next 1 day and …”).

Test setups worth recording

Pick a couple of scenarios and write them down — re-test them after every change to the working-days rule or holidays rule:

Scenario	Expected dispatch
Monday 09:00, cutoff 15:00, no holiday	Today
Monday 16:00, cutoff 15:00, no holiday	Tomorrow
Friday 16:00, cutoff 15:00, Mon is a holiday	Next Tuesday
Saturday any time, cutoff 15:00, Mon working	Monday

The Widget tab’s preview is fast — change the time of day on your dev box, save, refresh.