Delivery Date

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

PlacementOn a headless storefront
Product page and cart blocksNo. They need an Online Store theme.
The app proxy at /apps/delivery-dateNo. It runs through your online store.
CheckoutYes, on Shopify Plus.
Thank you and Order status pagesYes, 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.

KeyOnHolds
countriesShopDelivery time, arrival days and dispatch location per country
locationsShopCut-off, working days, processing time and closures per location
settingsShopHow the date is shown and worded, and the shipping zones read from your shipping settings
delivery_timeProduct and variantDelivery time per country for a product or variant
delivery_dateOrderThe delivery date calculated when the order was placed

You can see these metafields in your Shopify admin, but change them in the app.

Developer access with the app proxy and the metafields

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.

On this page