How to configure Delivery Date & Time


ShipperHQ’s Delivery Date & Time Advanced Feature enhances the shipping info shown to customers at checkout allowing you to show customers:

  1. Delivery Dates (eg. Fri, July 10)
  2. Time in Transit (e.g. 3 days)
  3. A calendar for selecting the delivery date and time (available on certain eCommerce platforms)


ShipperHQ Plan & eCommerce Platform

Displaying Delivery Dates or Time in Transit is supported on the ShipperHQ Starter Plan and up on the Magento 1 & 2, Adobe Commerce, BigCommerce, Shopify, SalesForce B2C Commerce Cloud, WooCommerce, Zoey, and eCommerce platforms.

Displaying a delivery date selector calendar is supported on the ShipperHQ Starter plan and up on the Magento 1 & 2, Adobe Commerce, and Zoey eCommerce platforms. It is also available for BigCommerce merchants on ShipperHQ Enterprise plans.

Calendar on Magento 2/Adobe Commerce
If you wish to display a date selector calendar at checkout on Magento 2/Adobe Commerce and you’re running the standard ShipperHQ extension, you will need to install the shipperhq/module-calendar additional module.

To display a date selector calendar for an In-Store Pickup carrier you’ll need to install both the shipperhq/module-calendar andshipperhq/module-pickup additional modules.

No additional modules are required if you wish to only display delivery dates or time in transit or if you are using the ShipperHQ Enhanced Checkout extension.

Supported Carriers

We support these time/date options on the following Carriers:

Small Package Carriers Custom Carriers LTL Freight Carriers
UPS Custom Table Rates TForce Freight (formerly UPS Freight)
FedEx In-Store Pickup Pitt Ohio
FedEx Ground Economy (formerly SmartPost) Same-Day Delivery
Canada Post

Setup Feature

In order to enable these features:

  1. Under the Advanced Features tab in the left navigation, enable Delivery Date & Time from the menu screen (screenshot below)
  2. Once enabled, you will see some feature settings if you click on the gear icon on that feature.To configure your Date & Time settings, Go back to Carriers and see “Live Rate Carriers” section below.

Feature Settings

If you click on the Delivery Date & Time feature itself, you will see 3 settings options:

  1. Could not determine Delivery Date message: This is where you can set the message that should appear if a Delivery Date is not determined.
  2. Lead Time Overrides Cutoff Time: If set to yes, cutoff time is ignored if a Lead Time has been applied
  3. Calendar Display Option: How the Calendar should display in Checkout (inline, or Popup). Only supported on Magento 1/2 and Zoey Platforms.


If you are using any form of time-in-transit capabilities (delivery date/time or a calendar) then it is necessary to set up the date-based information.

ShipperHQ asks for details on:

  • Blackout production days/dates – e.g. when is your factory not producing the goods. This could be set to 0 if you can ship items straight away. A great example is a picture framer who needs 5 days to produce the picture from time of order
  • Blackout shipment days/dates – when can the goods be picked up for delivery
  • Cut-off time – Whats the cut-off time for this origin to be able to ship goods. Only relevant if shipping on the same day

Carrier Configuration

  1. Under the carrier look for the Date & Time tab
  2. Under Include Delivery Date Information, choose between displaying shipping rates only, Delivery Date, Time in Transit, or Show Calendar
  3. a. When Delivery Date or Time in Transit are selected, you can update settings around Lead Times, Cut-off Times, or Blackout Dates.
  4. b. When Show Calendar is selected, you may determine the start and end dates of the calendar you’d like to display for delivery day. You may also define the total number of days available for the customer to select from. By default, ShipperHQ will use the lead time of the origin a product is shipping from as the lead time for this carrier, but if you choose to override that as it pertains to this specific carrier, you can do so here. Lastly, you can edit the blackout delivery dates of this carrier if necessary.
    Note: “Show Calendar” is not available on all eCommerce platforms. See Requirements for more info.
  5. Save the Carrier

Now your Live Rate Carrier will show Delivery Date or Time in Transit with the Shipping Rates and methods.

Max Number of Days to Show

When you select “Show Calendar” the field “Max Number Of Days to Show” will be displayed. The numerical value on that field will reflect on the checkout on the calendar, indicating how many days the customer will be able to select after the initial dispatch date. So for a value of 14 days, the number of days that will be allowed to be selected is up to 14 days from tomorrow, current dispatch date, but no days after that are available.

Show Cheapest Delivery Date

Cheapest Date with Calendar

When using the Calendar display option for Delivery Date & Time, there are two different factors for displaying the Cheapest Date.

  1. The first way to offer the Cheapest Delivery Date is to check the “Default to Cheapest Delivery Date” box below the main Date & Time settings. When this box is checked, the calendar will pre-select the date on the calendar that returns the cheapest available shipping rate. This functionality will take into account max time in transit, blackout delivery dates/days prior to auto-selecting that day on the calendar.For instance, let’s say that tomorrow (1st of the month) is an available delivery date, and expedited methods like Standard Overnight and Next day Air are returning, but there is no ground method (the least expensive method) for tomorrow. When that option is ticked, the calendar is going to default on the 4th of the month as that day is returning the “Ground” method, as it’s one of the least expensive methods.
  2. The second way to offer the Cheapest Delivery Date is to check the “Show Cheapest Option per Delivery Date” box. When this box is checked, we will only return the cheapest shipping method from that carrier per day. This option filters out more expensive shipping rates when multiple methods from this carrier have the same delivery date.
Cheapest Date with Delivery Date or Time in Transit

When using the Delivery Date or Time in Transit display options for Delivery Date & Time, selecting the the “Show Cheapest Option per Delivery Date” box will only return the cheapest shipping method from that carrier per day. This option filters out more expensive shipping rates when multiple methods from this carrier have the same delivery date.

Table Rate Carriers

On Table Rate Carriers, you can set Lead Times against your custom shipping methods and set additional Calendar Settings.

In your Table Rate Carrier, under the Basic tab, go to the Shipping Methods section. Edit your methods to add Lead Times. The lead times you set here will affect the Delivery Date shown against the method.

After lead times are set against the methods, Save the Carrier. You should now be set to show Delivery Date & Time against shipping methods.

For more information on customizing the text displayed for your delivery dates and time in transit, read about our explanatory text on the checkout.

Additional Info on Functionality

Read more about setting up Delivery Date & Time in ShipperHQ with the articles below:

Was this doc helpful?