Thank you page

Thank you page blocks are Checkout Buddy blocks for Shopify’s thank you page: the page buyers see right after they pay. Use them for a code for their next order, a link to share with friends, products that go with what they bought, when their order ships, answers to common questions, and notes under the items they ordered. You manage them on the Thank you tab on the Customizations page in Checkout Buddy.

They’re for the thank you page only. For the order status page, where customers check their order later, use customer account blocks.

What they need:

• Shopify plan: any except Starter. No Shopify Plus needed.
• Checkout Buddy plan: any. On Free, a thank you page block is your one customization; Deals & Rules and Buddy include as many as you need. See plans.
• An app block: the Thank you page app block, added once to each place you use in Shopify’s checkout editor. See set up thank you page blocks.

Blocks

Group	Blocks	Guide
Content	Banner, Text, Card, Image, Quick links, FAQ, Trust badges, Contact info, QR code	Content blocks
Offers and codes	Product offers, Discount code	Offers and codes
The order	What happens next, Order guide, Item note	Order blocks

Text in almost every block can greet the buyer by name or show their confirmation number, order total, pickup location and more. See personal text.

Set up thank you page blocks

The Set up your thank you page guide at the top of the Thank you tab ticks off each step as you finish it, and goes away once they’re all done. To hide it sooner, click the X at its top right. That hides it in this browser, for this store.

1. Add your first block. Click Browse customizations, or Create customization at the top of the page. Both open the Select customization page on its Thank you page cards. Choose a block type’s card, then Start blank or a template. See add a block.

2. Publish a block. New blocks start as drafts. In the block, turn on the switch in the Status card so it says Published, then save.

3. Add the app block to the thank you page. Click Open checkout editor, then switch to the Thank you page with the page selector at the top of Shopify’s editor. In each place you made blocks for (the main area, the announcement bar, the header or the footer), click Add block, choose Thank you page (under Checkout Buddy), and click Save. Once per place is enough. It shows every published block made for that place, including blocks you add later. Until every place with blocks has the app block in your live checkout, this step names the places still missing it.

Under customer information, under the items and under each item, Shopify’s editor has no Add block. Add the Thank you page app block to the page, then move it down with its arrows into Customer information (under Order details) or Items in cart (under Order summary). In Items in cart, the first spot is under each item and the next one is under the items. If that place has no blocks yet, the app block’s note in the editor names the place.

The announcement bar, the header and the footer are fixed spots: add the app block there once and it stays in that spot. Thank you page blocks show wherever you put their app block, for example in the main column or in the order summary.

Where blocks can go

When you edit a block, Where it shows lists the places that block type can go.

Place	What it is	Added in Shopify’s editor
Thank you page	In the page, wherever you add the app block	Yes
Announcement bar	A one-line message at the top of the page	Yes
Header	Under the store’s header, above the order details	Yes
Footer	At the bottom of the page	Yes
Under customer information	Below the contact, shipping and payment details	Yes, moved into Customer information
Under the items	In the order summary, below the list of items	Yes, moved into Items in cart
Under each item	A short note under the items that match its conditions	Yes, moved into Items in cart

Each block goes in one place, which you pick under Where it shows. Every place shows its blocks in the Thank you page app block, which you add once to that place in Shopify’s checkout editor. See set up thank you page blocks and where it shows.

Which places each block type can go

Block type	Thank you page	Announcement bar	Header	Under customer information	Under the items	Under each item	Footer
Banner	✓	✓	✓	✓	✓		✓
Text	✓		✓	✓	✓		✓
Card	✓		✓	✓	✓		✓
Image	✓		✓	✓	✓		✓
Quick links	✓		✓	✓	✓		✓
FAQ	✓			✓	✓		✓
Trust badges	✓		✓	✓	✓		✓
Contact info	✓			✓	✓		✓
QR code	✓			✓	✓		✓
Product offers	✓			✓	✓
Discount code	✓	✓	✓	✓	✓
What happens next	✓		✓	✓	✓
Order guide	✓			✓	✓
Item note						✓

Block types that only go in some places say why under Where it shows. For example, Item note says “Shows under each item that matches its conditions, so it only goes under items.”

Add a block

On the Thank you tab, click Create customization. The Select customization page opens on its Thank you page cards, one for each block type. Each card shows the places that type can go and how many templates it has, for example “Start blank or from 5 templates”. Click All at the top to see every kind of customization.

Narrow the cards with the search field, or with the groups above them, such as Offers and upsells, Content and trust or Order help.

Choose a card, and a window named after the block type shows Start blank first, then its templates under Or start from a template:

• Start blank starts from the block type’s defaults, named after the type.
• A template has the block’s content, place and conditions already filled in. The new block is named after the template.

The Text and Image cards have no templates, so they open a blank block. Everything can be changed before you save.

Card	Template	Place	Shows for
Banner	Welcome back	Header	Buyers who ordered before
	Pickup instructions	Header	Pickup orders
	Local delivery note	Under customer information	Local delivery orders
	Manage your subscription	Thank you page	Orders with a subscription
	Gift message confirmation	Under customer information	Orders with a gift message
Card	Join our list	Thank you page	Buyers not subscribed to emails
Quick links	Follow us	Footer	Every order
FAQ	Order questions	Thank you page	Every order
Trust badges	Why buyers love us	Footer	Every order
Contact info	Contact us	Under customer information	Every order
QR code	Get our app	Thank you page	Every order
Product offers	Complete the set	Thank you page	Every order
	Order again in one click	Under the items	Every order
Discount code	First-order thank you code	Thank you page	First orders
	Next-order code with QR	Thank you page	Every order
	Next-order code in the announcement bar	Announcement bar	Every order
	Share with friends	Thank you page	Every order
What happens next	What happens next	Thank you page	Every order
Order guide	Care and setup guide	Thank you page	Every order
Item note	Pre-order note	Under each item	Items tagged pre-order
	Personalization note	Under each item	Items with an Engraving property

Your thank you page blocks

The Thank you tab lists your thank you page blocks in a table, with each block’s ID, Name, Status (Published or Draft), Type, Where it shows, and when it was updated. Search by name, type or ID, filter by status or type, and sort the list. Click a block to edit it.

Edit a block

The block editor has these cards:

Card	What it’s for
Name	Only you see this. It names the block in your lists.
Content	The block’s text, buttons and settings. See the guide for each block.
Where it shows	The place, the block’s order, the place’s other blocks in order, and where the app block goes. See where it shows.
Who sees it	Conditions. See who sees it.
Translations	Text for your other store languages. See translations.
Status	Draft or Published.
Preview	A live preview with sample orders.
Recommended tips & guides	Links to the block’s guide and related help: placing the app block, personal text like {{ firstName }}, conditions and troubleshooting.

Save with Shopify’s save bar. Duplicate, at the top of the page, copies the block as a new draft. Delete block, at the bottom, removes it, and buyers stop seeing it right away.

Draft and published

New blocks, duplicates and imported blocks start as Draft: only you see them, in the preview. Turn the Status switch on to Published and save, and buyers see the block.

Preview

The Preview shows the block on a sketch of the thank you page, for one of five sample orders:

Sample	What the order is
First order	A guest’s first order, shipped, paid by card, with a welcome code
Returning customer	Jane’s 4th order, logged in, with an engraved item, paid with Shop Pay
Pickup	Picked up in store, with a gift message
Subscription	A coffee subscription with local delivery
B2B	A company order on payment terms

The preview runs the block’s conditions and personal text the same way the thank you page does. When a sample order wouldn’t show the block, a notice such as “Hidden for this returning customer” shows the conditions that hide it. If your store has more than one language, pick one at the top of the preview to see a translation. Your checkout’s colors, fonts and corners apply on the real page.

Where it shows

Setting	What it does
Place	One place, from the places this block type can go. See which places each block type can go.
Order in this place	Lower numbers show first; equal numbers show oldest first. For the announcement bar it’s Order: when several match, the lowest number shows, then the oldest.
Space below	None, Small, Medium or Large. Not for the announcement bar and under each item.

The card also shows:

• Where the Thank you page app block goes for this place, with Open Shopify’s checkout editor.
• [Place]: blocks in order, when a place has more than one block: every block for that place, with its ID, in the order buyers see them.
• An Advanced line about Block IDs, with this block’s ID, for blocks on the Thank you page place.

Which blocks show

Each place shows every published block made for it whose conditions match the order. They’re stacked by Order in this place, lower first, then oldest first.

The announcement bar shows one announcement: the first made for it whose conditions match, by Order, then oldest first. One that comes out empty for this buyer, such as personal text with no value, is skipped.

Under each item, each item in the order is checked against the block’s conditions, so a note shows only under the items it’s for.

Block IDs

The Thank you page app block has one setting, Block IDs. Leave it empty to show every block made for that place. That’s all most stores need.

To split the Thank you page place’s blocks across positions, for example a code at the top of the main column and offers in the order summary, add another Thank you page app block where you want it, and list block IDs in its Block IDs, separated by commas, such as 12, 15. It shows only those blocks, in that order, and only ones made for its place. Each block’s ID is in the ID column on the Thank you tab.

More than one app block in a place

Give every app block in that place Block IDs. An app block with an empty Block IDs shows every block for its place, so blocks can show twice.

Block IDs here is only for thank you page blocks. In checkout, the Content app block has its own Block IDs, and the Checkout Buddy (v1) app block uses Fixed block ID and Multiple block IDs.

Notes in Shopify’s editor

In Shopify’s checkout editor, the app block can show a note, Checkout Buddy (only you see this). Buyers never see it. It tells you when:

• No published thank you page blocks are made for that place yet.
• A block listed in Block IDs doesn’t exist, is a draft, or is made for another place.
• Block IDs is used, as a reminder to give every app block in that place Block IDs.
• Blocks are hidden because their conditions don’t match the order the editor previews with.

Under each item, notes show under the first item only, so they don’t repeat on every item.

Who sees it

Choose Every order, or Only orders that match conditions and click Add condition. For item notes, the choices are Under every item and Only under items and orders that match conditions. Search the list or pick a condition from its group.

• Conditions in the same box are joined with or: the block shows if any of them matches. Click Or… to add one.
• Boxes are joined with and: every box must match. Click And… to add a box.

Above the conditions, a sentence sums them up. Number and money conditions compare with is more than, is less than, is exactly or is not.

Group	Condition	What it checks
Customer	First order, Ordered before	Shopify’s own check: whether this is their first order with this email or account.
	Number of orders	Their orders, this one included. Only known customers match, not guests.
	Known customer, Guest	Whether they’re logged in or recognized by Shopify.
	Subscribed to emails, Not subscribed to emails	Their email marketing choice. Known customers only.
	B2B order, Isn’t B2B	Whether a B2B company placed the order.
	Company	is any of the company names, location names or company IDs you list, separated by commas.
This order	Order total	What they paid, with shipping and taxes. Use your store’s currency. Other currencies are converted at Shopify’s rate.
	Order subtotal	Items after discounts, before shipping and taxes, in your store’s currency like Order total.
	Number of items	How many items they bought.
	Contains	any of or none of the products you choose.
	Product type, Vendor	Any item with one of the product types or vendors you add. Add each on its own, so a name with a comma like Acme, Inc. stays one name.
	Product tag	Any item’s product tags: has any of or has none of the tags you list.
	Has a subscription, No subscription	An item bought as a subscription, pre-order or try before you buy.
	Discount code	is any of, is none of, any code used or no code used.
	Order attribute	An order attribute by name, like a gift message from a form: is, is not, contains, doesn’t contain, has a value or is empty.
Delivery and payment	Delivery method	Shipping, Local delivery, Pickup in store or Pickup point.
	Shipping country, Shipping province or state	Two-letter country codes, such as CA, US, or province and state codes, such as ON, NY.
	Payment method	Credit card, Wallet (Shop Pay, Apple Pay, PayPal…), Gift card or store credit, Local payment method, Offsite payment, Cash on delivery, Manual payment or Pay later (payment terms).
	Paid with a gift card	A gift card paid for some or all of the order.
Language, country and schedule	Language	Language codes, such as fr, de. “fr” also matches “fr-CA”.
	Market country	Two-letter codes of the country they shopped in. For where the order goes, use Shipping country.
	Date	is after or is before a date, in the buyer’s time zone. Add both to show a block between two dates.
This item	Item is	any of or none of the products you choose.
	Item product type, Item vendor, Item product tag	The item’s product type, vendor or product tags.
	Item is a subscription	The item was bought as a subscription, pre-order or try before you buy.
	Item property	A line item property, such as a personalization, by name.

Conditions under This item are only for blocks Under each item. Other blocks say that “This item” conditions only work in item notes.

Translations

Each block has its own Translations card. Pick a Language (each shows how many of the block’s texts are translated) and fill in the fields. Leave a field empty to show your default text.

• Buyers see the translation for the language they checked out in: an exact match such as French (Canada) first, then the language on its own.
• Personal text works in translations the same way.
• Links, discount codes and metafield names aren’t translated.
• Text Checkout Buddy adds itself, such as Copy code, Shop now, Add to cart, and the default steps of What happens next, comes in English and French. Other languages show it in English. To show those steps in another language, write your own steps and translate them.

If your store has one language, the card says so. Add a language in Shopify under Settings → Languages and publish it to translate blocks.

Export and import

In the Settings card on the Thank you tab, Export blocks downloads all your thank you page blocks as one file, with their content, place, conditions and translations. Use it as a backup or to copy your setup to another store.

Import blocks adds every block in a file exported from this tab. Imported blocks start as drafts, so check them in the preview and publish the ones you want. The file only holds thank you page blocks, not checkout blocks, functions or account blocks. On the Free plan, an import adds only what’s left of the plan’s one customization.

Plans

Checkout Buddy plan	Thank you page blocks
Free	Count as the plan’s 1 customization: one checkout block, function, thank you page block or account block in total. Every thank you page block type works on Free.
Deals & Rules	Included, as many as you need.
Buddy	Included, as many as you need.

Thank you page blocks work on every Shopify plan except Starter, and stores on any of those plans can choose Deals & Rules. They were on the Thanks & Accounts plan until November 11, 2026. Stores on it keep it, with everything in Deals & Rules. When your plan has no room for another thank you page block, the tab shows Free plan limit reached, asks you to upgrade your plan and suggests one, such as the Deals & Rules plan. See plans and billing.

Checkout blocks from before

Before thank you page blocks, some checkout blocks (Banner, Text, Image, FAQ, Contact info and Line item text) could show on the thank you page. The Thank you page app block still shows the ones its Block IDs list, with the thank you page’s look. See checkout blocks on the thank you page.

To replace one, make a thank you page block, then put its ID in Block IDs instead of the old one. Templates such as Order questions and Contact us replace the old FAQ and Contact info blocks.

Things to know

• Not on Shopify Starter. On Shopify Starter, the thank you page doesn’t show app blocks. If your store moved to Starter after making some, the Thank you tab stays so you can turn them off or delete them. They show again on Basic or higher.
• The order is already placed. Blocks can’t change it, and offers start a new cart instead of adding to this order.
• One announcement per page. Only the first matching announcement that isn’t empty shows.
• One app block per place. The Thank you page app block shows every block made for its place. Add a second one only to split blocks across positions, and then give every app block in that place Block IDs. See block IDs.
• The order number is the confirmation number. Shopify doesn’t give apps the order name (#1001) on the thank you page, so {{ orderNumber }} shows the confirmation number, such as X7KQ2PL9A. See personal text.
• No customer tags or store credit balance. Shopify doesn’t share them with the thank you page, so there are no conditions for them. Use customer account blocks for those. Payment method can still check whether they paid with a gift card or store credit.
• Closing a banner only hides it on that order’s page. Shopify resets what an app remembers in checkout for every new order, so a closed banner or announcement shows again on the buyer’s next order.
• Analytics counts Product offers only, with Record sales for Analytics on, on its Thank you page tab. Other thank you page blocks aren’t listed. See analytics.
• Products are saved by their Shopify ID. After importing blocks into another store, choose the products again in Product offers and in Contains and Item is conditions.