Preferred delivery dates

The delivery-date field lets a buyer select a preferred date within the configured window. It is stored with the order as a date. It is not a carrier promise and does not change the carrier's own rate or transit calculation.

Configure the window

Under Extra Features, enable Enable Delivery Date, then set:

  • Minimum Lead Time in days
  • Maximum Advance in days
  • Disabled Weekdays
  • Holiday Calendar Country
  • Additional Blackout Dates

The window uses the store's timezone. A selected date must be within the minimum and maximum dates, must not use a disabled weekday, and must not be in the resolved blackout list.

Blackout formats

Enter one value per line:

  • YYYY-MM-DD blocks one date.
  • MM-DD blocks that month and day every year.

The selected holiday country uses the Yasumi provider available for that country. Choose None when no public-holiday calendar should be applied.

Validation and storage

The browser date picker receives the calculated range and blackout dates. The server validates the submitted YYYY-MM-DD value again. Invalid, out-of-range, disabled or blacked-out dates are rejected. A valid value is copied to sales_order.delivery_date and shown in the success page and Admin order view.

Lead time, date range and disabled weekdays in Magento Admin

Preferred delivery date calendar in One Step Checkout