Add your first block to checkout

Showing a block at checkout takes two parts. First you create the block in Checkout Buddy, then you place its app block in checkout using Shopify’s Checkout Editor. The block won’t appear until both are done.

Requires: Shopify Plus (or a development or Plus sandbox store).

Not on Shopify Plus?

Checkout blocks are the only blocks that need Plus. Start with one of these instead:

• Product offers on product and cart pages: upsells, add-ons and free gifts, shown through your theme. Every Shopify plan except Starter.
• Discounts and checkout rules: no block to place. Most work on every Shopify plan.
• Thank you page blocks and customer account blocks. Every Shopify plan except Starter.

See which Shopify plan do I need?

Prefer to watch? The setup video makes a Product offers block and places it, from 0:36.

Part 1: Create the block

1. In Checkout Buddy, open Customizations. On the Content tab, click Create customization. For custom fields, use the Fields tab, and for product offers and progress bars, the Upsells tab.

2. The Select customization page opens on Checkout content. Pick a card, such as Banner, Text or Trust badges. To narrow the list, search by name or click a group above the cards, such as Content and trust or Order help.

   The tiles at the top, from Upsells and gifts to Templates and All, switch to other kinds of customization, and each shows how many it holds. Templates has ready-made setups: see templates and recipes.

   

3. Give the block a Name. Only you see it.

4. Fill in the block’s settings. A content block has Parts, a Look and a Preview; each block’s page in this help center explains its settings.

5. Under Who sees it, keep Every checkout for now. You can add rules later.

6. Under Status, turn on the switch so it reads Published, then click Save. New blocks start as Draft, which only shows in the editor’s preview.

Part 2: Place it in the Checkout Editor

Each kind of block has its own app block. Content blocks, progress bars, Reviews, What happens next and automations use the Content app block, Product offers the Product offers app block, and Custom fields forms the Custom fields app block. Where it shows, in the block’s editor, names the app block and links to Shopify’s checkout editor. See app blocks in the Checkout Editor for all of them.

1. In Shopify admin, go to Settings → Checkout and click Edit next to your active checkout configuration. Until your blocks are added, the setup guide on Checkout Buddy’s Home page has an Open checkout editor button too.

2. Use the page selector at the top to go to the checkout step where you want the block: Information, Shipping, or Payment.

3. Click Add block in the section where you want the block, and choose Content under Checkout Buddy.

   

4. Leave Block IDs empty to show every published content block whose rules pass, or enter a block’s ID to show only that one there. Its ID is under Status in its editor, and in the ID column on Customizations.

   

5. Use the up and down arrows on the app block in the preview to adjust its position if needed.

6. Click Save in the top-right corner.

Open your store, add a product to the cart, and go to checkout to see the block. Back in Checkout Buddy, the block’s Where it shows stops warning that the app block isn’t in your live checkout.

Adding the app block more than once?

A Content app block with empty Block IDs shows every content block, oldest first. When you add the app block in more than one place, list IDs in each, so no block shows twice. See which blocks an app block shows.

Choosing where to place it

Some blocks only work in particular places:

• Text under each item or shipping method: place a Content app block under each item or under each shipping method, list the block’s ID in its Block IDs, and use This item or This shipping method rules. See where to place it.
• Line item text, Line item upsell, and Cart line editor show under each product in the order summary, in the Cart line item app block. See placement.
• Automations don’t show anything. Place the Content app block in one of checkout’s sections, somewhere on every step where it should act, such as the order summary.
• Product offers and Custom fields have their own app blocks, named after them.
• The thank you page has its own blocks, made on the Thank you tab, with an app block called Thank you page. See thank you page.

Blocks made before the Content block

Blocks made before the Content block, such as an older Banner, Text or Apply discount code, and the blocks still made the older way (SMS consent, Address validator, Apply line item attribute, for stores that installed Checkout Buddy before November 11, 2026), show in the Checkout Buddy (v1) app block instead:

1. In the Checkout Editor, click Add block and choose Checkout Buddy (v1).

2. In the app block’s settings on the left, enter your block’s ID in Fixed block ID.

   

3. Click Save.

Always fill in Fixed block ID

If Fixed block ID is empty, the Checkout Buddy (v1) app block shows one of all your enabled older blocks, chosen at random. That’s the most common reason the wrong block appears. See which block shows.

If the block doesn’t appear

Check these in order:

1. The block’s Status reads Published (or Enabled, for older blocks) in Checkout Buddy.
2. The Checkout Editor was saved after you added the app block.
3. It’s the right app block: Content for content blocks, Product offers for Product offers, Custom fields for forms, Checkout Buddy (v1) for older blocks.
4. The app block’s Block IDs is empty or lists the block’s ID (or Fixed block ID matches, for older blocks).
5. The block’s rules pass for your test cart.
6. You’re looking at the checkout page the app block was placed on.

Still stuck? See block not showing.