Show estimated delivery dates across WooCommerce
Updated September 20, 2026
Estimated delivery display lets you show the same Delivery Dates calculation across product pages, archives, the cart, checkout, order pages, emails, shortcodes and blocks. You can choose a presentation and concise wording for each placement without changing the underlying calculation.
Choose the estimated delivery display format#
Open WooCommerce > Delivery Dates > Display. Under Message format, choose one of these customer-facing results:
- Simple date: one calculated delivery date.
- Simple range: a compact start and end range.
- Full date range: the complete formatted start and end dates.
The Earlier range days and Later range days controls appear only when a range mode is selected. Earlier days move the range start earlier than the calculated carrier estimate, while later days move the end later. Leave the custom date format blank to use the WordPress date format.
Set wording and presentation for each placement#
The Placement and presentation card keeps each storefront location, its presentation and its optional wording together.
- Find the required placement, such as Product pages or Shipping methods in cart and checkout.
- Enable Show delivery where the placement is optional.
- Choose Plain text or Styled panel.
- To replace the global message at this location, enable Use custom wording and enter a message using
{date},{date_from}or{date_to}. - Save and check the relevant storefront page.
For example, set product pages to Delivery: {date} and shipping methods or the overall cart estimate to Estimated delivery: {date}. The custom field remains hidden until its toggle is enabled, keeping the page easier to scan.
Refresh cached frontend estimates#
Refresh cached frontend estimates is enabled by default. Product, archive, shortcode and Delivery Date block output is refreshed after cached HTML appears, using one deferred batched request per page rather than one request per product. This helps a cached page reflect the visitor’s current WooCommerce location and session.
Disable the setting under Placement and presentation if the extra request is undesirable on constrained hosting. When a refresh fails, the page keeps its original estimate instead of replacing it with an error.
Show an estimate in classic and Block mini-carts#
Enable Mini-cart summary under Placement and presentation to show one overall delivery estimate in the classic WooCommerce mini-cart and the WooCommerce Mini-Cart Block. Choose plain text or the styled panel and, if needed, set placement-specific wording.
Before a customer chooses a shipping service, the summary uses the same quickest applicable estimate as the product page. This prevents WooCommerce’s provisional session rate from making the mini-cart promise look later than the product promise. Once the customer chooses a service in the cart or checkout, use the shipping-method placement to show that service’s own estimate.
Leave the mini-cart summary disabled when a compact mini-cart has insufficient space or when the theme already shows an equivalent promise.
Style plain text or the styled panel#
Plain text styling controls the text colour, pixel size, weight and font family. It is normally the clearest choice beneath a shipping method. On classic WooCommerce cart and checkout layouts, including Flatsome, the package estimate sits directly beneath its shipping method.
Styled panel styling controls text size, text colour, background, border colour, corner radius and icon. Set the radius to 0 for square corners, enable Remove styled-panel border for no border, or enable Use transparent styled-panel background for no filled background. You can use a built-in icon, upload an icon or choose no icon.
Each styling card includes a simple inline Live preview. The explanation and label sit on one line, while the customer message retains the selected styling beneath it.
Use message wording safely#
Use the placeholders shown beside each wording field. Basic formatting is available automatically in all delivery and cut-off wording. For example, Delivery: <strong>{date}</strong> makes only the date bold and the live preview reflects it immediately. Safe bold, italic, line-break, span and link markup is retained; scripts, styles, iframes and event handlers are removed.
Append an estimate to the stock status#
On product pages, Delivery Dates automatically appends the plain message to an available WooCommerce stock status, producing a compact line such as In stock – Delivery: Tomorrow. It works with themes that render WooCommerce availability text directly, including XStore. If the product has no stock-status text, the estimate appears on its own at the selected product-page fallback position.
Use relative delivery wording without shortening the promise#
Enable Relative delivery wording when you want simple estimates to read Today, Tomorrow or the weekday for nearby dates. Set the full-date threshold, up to 31 days, and edit the same-day, next-day and weekday wording. Estimates beyond the threshold always use the full date. Ranges retain explicit dates so customers cannot infer an earlier arrival.
Add a delivery cut-off countdown#
Enable the Cut-off countdown to show the time remaining until the current weekday cut-off, falling back to the global cut-off where needed. Choose the site’s WordPress time format, a 12-hour format or a 24-hour format for the customer-facing cut-off. In 12-hour mode, whole-hour cut-offs are shown without minutes, such as 3pm.
After the cut-off, delivery calculations move zero-day preparation orders to the next eligible store day before carrier transit is applied. In after-cut-off wording, use {next_store_day} to show that next weekday configured for store preparation. You can also hide the countdown and its after-cut-off wording until a specified time on the next calendar day, such as 03:00.
Use [regal_delivery_cutoff] in shortcode-supported content, or add the Delivery Cut-off Countdown block in the block editor. The [regal_delivery_date] shortcode accepts presentation="plain" or presentation="styled" when a placement needs an explicit override.
Use shipping method delivery wording#
Each rate in the cart and checkout is calculated against its own shipping-method rule. Product pages use the quickest applicable estimate until the customer chooses a shipping method.
- Open WooCommerce > Delivery Dates > Shipping rules.
- Open Shipping method rules and edit the relevant method.
- Enable Use custom delivery wording for this shipping method.
- Enter a message, for example
Guaranteed Delivery: {date}, then save.
The shipping-method override takes priority over placement and global wording for that method only. Leave it off to use the package placement wording, or the global plain or styled wording when no placement override is enabled.
Choose the right locations#
- Product pages: useful before the Add to Cart button for purchasing confidence.
- Shop and archive pages: useful where products share broadly similar delivery rules.
- Cart and checkout: use package output when the shipping service can change the delivery calendar.
- Thank-you, account and email: use the saved checkout estimate as the historical record.
See the WooCommerce product content guide if you need help choosing a theme or block placement.
