Order blocks

Order blocks answer what buyers ask right after they pay: when it ships, when it arrives, how to look after what they bought, and anything special about one of their items.

Requires: any Shopify plan except Starter (no Shopify Plus needed), and the Thank you page app block in Shopify’s checkout editor. Thank you page blocks come with the Deals & Rules and Buddy plans, or count as the Free plan’s one customization. See set up thank you page blocks.

Block	What it shows	Can go
What happens next	The order’s steps with dates: ships by, arrives by, or ready for pickup	Thank you page, Header, Under customer information, Under the items
Order guide	Care, setup or warranty info for each item, from your products’ metafields	Thank you page, Under customer information, Under the items
Item note	A short note under the items it’s for: pre-order dates, ships separately, personalization	Under each item

What happens next

Setting	What it does
Heading, Intro	Optional heading and text above the steps.
Days to prepare an order	Shipping days before the order leaves. The default is 1.
Same-day cutoff	Orders after this hour start the next day, in the buyer’s time. New blocks start at 12 PM. Or No cutoff.
Days you ship	The days of the week you ship. Monday to Friday by default. Choose at least one.
Add a day you don’t ship	Holidays and other days off, up to 30.
Days in transit, from, to	Optional. How long delivery takes after the order ships.
Count days in transit as	Business days, as Shopify does (the default, Monday to Friday) or Calendar days.
Days until a pickup order is ready	For pickup orders. The default is 0, the same day.
Steps for shipped orders, Steps for pickup orders	Up to 6 steps each, with a Title, an Icon and optional Text. Leave them empty to use the default steps.

How the dates work

1. Start: today, or the next day you ship when the order comes in after the cutoff or on a day you don’t ship.
2. Ships by: the start plus Days to prepare an order, counting only days you ship.
3. Arrives: the ship date plus your Days in transit, counting business days, Monday to Friday, as Shopify does for the dates under each shipping method in checkout. Your days off move the ship date, not the delivery. Choose Calendar days to count weekends too. Without Days in transit, steps that mention {{ deliveryDate }} leave their text out instead of showing a blank.
4. Pickup orders get their own steps: ready by the start plus Days until a pickup order is ready. Under the steps, the block shows where to pick up, such as “Pick up at Shop location, 410 Queen Street West, Toronto”.

Match your shipping rates

Shopify shares a shipping method’s delivery estimate, such as “3 to 9 business days”, in checkout only, not on the thank you page. Set Days in transit to match your shipping rates, so the dates agree with the checkout block of the same name.

Dates use the buyer’s clock and time zone, because the thank you page doesn’t know your store’s. They show in the buyer’s language, such as “Tue, Oct 13”.

Default steps

Shipped orders	Pickup orders
Order confirmed: We’ve received your order and sent you a confirmation email.	Order confirmed: the same text
Preparing your order: Ships by (date).	Preparing your order: We’re getting your items ready.
On its way: We’ll email you tracking details when it ships.	Ready for pickup: Ready by (date). We’ll let you know when you can collect it.
Delivered: Expected (dates).

Default steps come in English and French. The first step always shows as done.

Your own steps

Write your own steps to change the wording or add a step. Put dates in a step’s text:

Variable	What it shows	Example
shipDate	The ship-by date	Tue, Oct 13
deliveryDate	The arrival dates, as a range when the estimate is one	Fri, Oct 16 – Tue, Oct 20
deliveryDateFrom, deliveryDateTo	The first and last arrival date	Fri, Oct 16
readyDate	When a pickup order is ready	Mon, Oct 12
carrier	The carrier’s name, when the shipping rate has one	Canada Post

For example, Arrives {{ deliveryDate }} with {{ carrier || "our courier" }}. All personal text works in steps too. Every step needs a title. To show your steps in another language, translate them on the block’s Translations card.

Template: What happens next. The same block is also in checkout, with dates for an order placed now, and on the Order status page, where it ticks steps off as the order ships.

Order guide

Setting	What it does
Heading, Intro	Optional heading and text, such as “Getting started”.
Add product metafield	Up to 5 product metafields to show. Each has a Namespace, a Key and an optional Heading, such as “Care”.

The block lists each product in the order that has a value, by name. Buyers open a product to see its values, each under its heading; with one product, it’s already open. Products without values are left out, and the block doesn’t show when no product has one.

Metafield type	Shows as
Single line or multi-line text	Text. Bold (**…**) and links work.
Rich text	Text, with its bold, links and paragraphs
URL, file or image	A link that opens it

Values show as written: personal text doesn’t work in them.

Set up the metafields

Note

The order guide shows your own product metafields. Checkout Buddy doesn’t create them.

1. In Shopify, go to Settings → Custom data → Products and add a metafield definition, for example Care instructions with the namespace and key custom.care_instructions.
2. Fill it in on your products.
3. In the Order guide block, enter the same Namespace and Key, then save. Checkout Buddy turns on the definition’s Storefront access when you save, because the thank you page reads product metafields through Shopify’s Storefront API.

If you add the definition after saving the block, save the block again. A metafield without a definition shows nothing.

Template: Care and setup guide, which reads custom.care_instructions under the heading Care.

Item note

Setting	What it does
Note	Required. Supports bold, links, one paragraph per line, and personal text.
Color	Subdued (gray), Info (blue), Success (green), Warning (yellow) or Critical (red).
Icon	Optional, shown before the note.

An item note only goes Under each item. Choose which items it goes under in Who sees it, with the This item conditions: Item is, Item product type, Item vendor, Item product tag, Item is a subscription and Item property. Without conditions, it shows under every item.

Notes can show the item’s own details with line. variables, for example We'll engrave "{{ line.attributes["Engraving"] }}" on your {{ line.title }}. See personal text.

Templates: Pre-order note (items tagged pre-order) and Personalization note (items with an Engraving property).