Headless storefronts
Delivery Date on a headless Shopify storefront: which pages show the date, why the theme blocks don't, and the metafields your own theme code can read.
On a headless storefront, such as one built with Hydrogen, your pages don't come from a Shopify theme. Checkout and the pages after it still run on Shopify.
What works
| Placement | On a headless storefront |
|---|---|
| Product page and cart blocks | No. They need an Online Store theme. |
The app proxy at /apps/delivery-date | No. It runs through your online store. |
| Checkout | Yes, on Shopify Plus. |
| Thank you and Order status pages | Yes, on every plan except Shopify Starter. |
Metafields
The app keeps your settings in app-owned metafields. The Liquid of an Online Store theme can read them under the namespace app-- followed by the app's ID. Developer access on the Overview shows the exact namespace. The Storefront API and other apps can't read them, so a headless storefront can't either.
| Key | On | Holds |
|---|---|---|
countries | Shop | Delivery time, arrival days and dispatch location per country |
locations | Shop | Cut-off, working days, processing time and closures per location |
settings | Shop | How the date is shown and worded, and the shipping zones read from your shipping settings |
delivery_time | Product and variant | Delivery time per country for a product or variant |
delivery_date | Order | The delivery date calculated when the order was placed |
You can see these metafields in your Shopify admin, but change them in the app.

A ready-made date for your theme
Developer access also shows the app proxy, an address your theme's own code can call for a finished date: /apps/delivery-date/delivery-date on your store's domain. Add variantId once for each product variant, country with a two-letter country code, and locale for the wording's language. It runs the same calculation as the blocks and returns the date and your wording. Like the blocks, it works only on your online store.
The placeholders you can use in your wording are listed under Wording.