Advanced Holidays Configuration
The Estimated Delivery module lets you configure holidays with precise control over what gets blocked and who it affects. A holiday can block only the picking phase, only the shipping phase, or both — and it can be limited to specific carriers or delivery zones rather than applying globally.
This page requires Advanced Mode to be enabled in the module settings for the carrier/zone filters to appear.
⚙️ What the Basic Holiday System Does
Every holiday has a date range (start → end date) and an optional Repeat yearly toggle. When a date falls within a holiday, the module skips it and moves the delivery estimate forward.
By default, a holiday:
- Blocks both picking and shipping for that date
- Applies to all carriers
- Applies to all delivery zones
Advanced holidays let you narrow each of these three dimensions.
📅 Holiday Scope — What Phase Gets Blocked
Each holiday has a Scope setting with three options:
| Scope | What is blocked | When to use |
|---|---|---|
| Both (default) | Picking + shipping | Warehouse and carriers both closed — Christmas, Easter |
| Picking only | Warehouse doesn't dispatch, carriers still deliver | Inventory day, internal warehouse closure |
| Shipping only | Warehouse works, carrier doesn't deliver | Carrier-specific national holiday |
Example: Your warehouse is open on 14 July (Bastille Day) but La Poste doesn't deliver in France that day. Set scope to Shipping only and restrict it to the La Poste carrier and the France zone — all other carriers and zones remain unaffected.
🚚 Carrier Filter — Limit to Specific Carriers
By default, a holiday applies to every carrier. With the Carriers filter (visible in Advanced Mode), you can limit the holiday to one or more specific carriers.
This uses the carrier's reference ID (id_reference), which survives carrier ID changes when you duplicate or update a carrier in PrestaShop.
When to use:
- A courier is closed for a local public holiday but your other carriers operate normally
- You have a same-day courier that doesn't run on Sundays while standard carriers do
🌍 Zone Filter — Limit to Specific Zones
The Zones filter limits the holiday to one or more PrestaShop delivery zones (Europe, North America, etc.).
When to use:
- A national holiday affects only customers in one country/zone
- Your warehouse serves multiple zones with different local calendars
If you set both a carrier filter and a zone filter, the holiday applies only when both conditions match — the order must use that carrier and ship to that zone.
➕ How Multiple Holidays on the Same Date Combine
When two or more holidays overlap on the same date, their restrictions combine (union). No holiday overrides another:
| Holiday | Scope |
|---|---|
| Christmas (Dec 25) | Both |
| UPS Holiday (Dec 25) | Shipping only |
Result on Dec 25: both picking and shipping are blocked (the more restrictive combination wins for each phase independently).
🔧 Creating an Advanced Holiday
- Go to Back Office → Estimated Delivery → Holidays
- Click Add holiday
- Fill in the name, start date, and end date
- Choose whether to repeat yearly
- Set the Scope (Both / Picking only / Shipping only)
- If Advanced Mode is enabled:
- Carriers: leave as "All carriers" or select specific ones
- Zones: leave as "All zones" or select specific ones
- Save
The holiday appears in the list with Scope, Carriers, and Zones columns (visible in Advanced Mode).
💡 Common Configurations
Warehouse inventory day (picking blocked, shipping unaffected)
- Scope: Picking only
- Carriers: All
- Zones: All
Carrier-specific national holiday
- Scope: Shipping only
- Carriers: Select the affected carrier(s)
- Zones: Select the affected zone(s)
Full closure for a specific market
- Scope: Both
- Carriers: All
- Zones: Select only the affected zone
Standard public holiday (affects everyone)
- Scope: Both
- Carriers: All
- Zones: All
- Repeat yearly: On
✅ Final Checklist
- Advanced Mode is enabled in module settings (required to see carrier/zone filters)
- Scope is set correctly for each holiday (Both / Picking only / Shipping only)
- Carrier filters applied where the closure is carrier-specific
- Zone filters applied where the closure is region-specific
- "Repeat yearly" enabled for recurring annual holidays
Do I need Advanced Mode enabled to use holidays at all?
No. Basic holidays work without Advanced Mode — you can add date ranges with yearly repetition and they will block both picking and shipping for all carriers and zones. Advanced Mode is only required to see the carrier and zone filter columns and to create targeted holidays.
What is the difference between Picking only and Shipping only scope?
Picking only blocks your warehouse from dispatching orders but leaves carriers operating normally — useful for internal events like inventory days. Shipping only means your warehouse is open but the carrier does not deliver — useful for carrier-specific national holidays. Both blocks everything.
Can I apply a holiday to just one carrier without affecting others?
Yes. In Advanced Mode, use the Carriers filter when creating the holiday and select only the affected carrier. Other carriers will calculate delivery estimates as normal on that date. The filter uses the carrier reference ID so it remains valid even if the carrier is updated.
If I have two holidays on the same date with different scopes, which one applies?
Both apply simultaneously and their effects are combined. If one holiday blocks picking and another blocks shipping on the same date, both picking and shipping are blocked. No holiday overrides another — they accumulate.
How do I handle a national holiday that only affects customers in one country?
Create the holiday with the appropriate scope (usually Shipping only), then use the Zones filter to limit it to the zone that corresponds to that country. Orders destined for other zones will not be affected.