A block isn't showing

A block shows when three things are true: it’s turned on in Checkout Buddy, its app block is added and saved in Shopify’s editor, and its rules or conditions pass. Each kind of block has its own app block and its own checklist:

Your block	Shows in	Checklist
A Product offer in checkout	The Product offers app block	Product offers
A Product offer on a product page, the cart page or the cart drawer	The Product offers block in your theme	On product and cart pages
A content block (banner, text, trust badges and so on), or a progress bar, Reviews, What happens next or automation made since the Content block	The Content app block	Content blocks
A Custom fields form	The Custom fields app block	Custom fields forms
A thank you page block	The Thank you page app block	Thank you page blocks
A customer account block	The Customer accounts app block	Customer account blocks
Cart line editor, Line item text or Line item upsell	The Cart line item app block	Checks 1 to 8
A block made before the Content block, such as an older banner, form field or progress bar	The Checkout Buddy (v1) app block	Checks 1 to 8

Not sure which kind yours is? On Customizations, the Kind column names each checkout block’s app block, such as Checkout · Content app block.

Blocks in checkout need Shopify Plus. Product offers on product and cart pages, thank you page blocks and customer account blocks don’t: they show on every Shopify plan except Starter.

Product offers

For an offer made with Product offers, check these in order:

Is the offer published? Its Status card should say Published. New offers start as Draft, which only shows in the editor’s Preview.
Is the Product offers app block in checkout, and saved? Product offers show in their own Product offers app block, not the Checkout Buddy (v1) one. Add it in Shopify’s checkout editor, then save the editor. Until you do, the offer’s Checkout card says “The Product offers app block isn’t in your live checkout yet.”
Does the app block have Block IDs? If its Block IDs setting lists IDs, it only shows those offers. Add the offer’s ID, shown in its Status card, or leave Block IDs empty to show every offer. With Show first match only ticked, only the first offer whose conditions pass shows in that app block. See which offers an app block shows.
Do the conditions match? Check Who sees it. In Shopify’s checkout editor, the app block shows notes only you see, explaining which offers show and why others are hidden. An offer with a Market condition stays hidden when checkout doesn’t report the buyer’s market.
Does the offer have something to show? It shows nothing when none of its products are available, or a collection or Shopify’s suggestions return nothing. An offer set to Hide the whole offer under Once a product is in the cart hides once a product is in the cart. An offer set to Mobile and tablet only or Desktop only under Devices hides on other devices. An offer that suggests products that reach a goal hides once the cart reaches the goal, or when no product closes the gap. See close the gap.
Did a gift come back out? With Remove gifts that aren’t free ticked, an offer takes a gift back out when checkout charges for it. Make sure a discount makes the gift free. See gifts that aren’t free. B2B buyers only get gifts from offers whose conditions include B2B order or Company.
Is your store on Shopify Plus, on the Buddy plan? Offers show in checkout only on Shopify Plus stores, and development and Plus sandbox stores. Otherwise the offer’s editor shows a Needs Shopify Plus warning: tick Product pages or Cart page under Where it shows instead, which work on every Shopify plan except Starter.

Offers never add gifts in Shopify’s checkout editor. Test gifts in a real checkout.

On product and cart pages

For an offer with Product pages or Cart page ticked under Where it shows, check these in order:

Is the offer published? As above.
Does Where it shows warn you? It won’t show on product and cart pages names what only checkout can do, such as a Fee or a checkout-only condition. See what works on product and cart pages. Shopify Starter stores can’t add the block to their theme, so offers don’t show there.
Is the Product offers block on that page of your live theme? The offer’s Product and cart pages card shows each page’s step as done once it is. Add the block, then click Save in Shopify’s theme editor. Other pages, like your home page, need their own block. See set it up.
Does the block have Offer IDs? If it lists IDs, it only shows those offers.
Does the page match Show with these products? On a product page, the offer shows only on those products’ pages; on the cart page, only while the cart has one of them, and never on an empty cart. Other pages show only offers with nothing under Show with these products.
Do the conditions match? Check Who sees it. A Customer tags condition set to has any of never passes for guests, who have no tags: test while logged in as a customer with the tag.
Is your theme an Online Store 2.0 theme? Older themes can’t take app blocks or app embeds. The Product and cart pages card says “Your live theme can’t show app blocks. It needs an Online Store 2.0 theme, like Shopify’s free themes.”
Is the cart drawer empty? The drawer needs the block on your cart page and the app embed on. See the cart drawer.
Is a gift missing? Turn on the app embed, and check that a discount makes the gift free. With Remove gifts that aren’t free ticked, a gift the cart charges for comes out, and an automatic gift then stops showing for the rest of the visit. Unticked, the gift stays at its price. See gifts that aren’t free.

For more causes, such as products that can’t be offered or a theme the block can’t be added to, see if an offer doesn’t show.

Content blocks

For a content block, or a progress bar, Reviews, What happens next or automation made since the Content block, check these in order:

Is it published? Its Status card should say Published. New blocks start as Draft, which only shows in the editor’s Preview.
Is the Content app block in checkout, and saved? These blocks show in the Content app block, not the Checkout Buddy (v1) one. Add it in Shopify’s checkout editor, then save the editor. Until you do, the block’s Where it shows card says “The Content app block isn’t in your live checkout yet.”
Does the app block have Block IDs? If its Block IDs setting lists IDs, it only shows those blocks. Add the block’s ID, shown under Status, or leave Block IDs empty to show every block. Progress bars, Reviews and automations show (or run) under each item, shipping method or pickup location only when that app block lists their ID.
Is it on the right step? An app block in a step’s own section shows only on that step, and a buyer has to reach it. To show a block, or run an automation, on every step, put the app block in a section every step has, such as the order summary.
Do the rules match? Check Who sees it (Which checkouts, for an automation): the line above the rules reads them back in words. A rule about something checkout doesn’t know yet, such as the shipping address before the buyer enters it, keeps the block hidden until it knows. This item, This shipping method and This pickup location rules only pass in an app block placed under each of them. In Shopify’s checkout editor, the app block shows notes only you see about hidden blocks. See Content rules.
Is it set to show on other devices? Show on can limit a block to phones or computers.
Is it hidden by Show first match only? With it ticked, only the first block whose rules pass shows in that app block.
Does the block have something to show? A block with no parts filled in, or What happens next for a cart with nothing to ship or pick up, shows nothing.

An automation shows nothing unless it has a message, and never runs in Shopify’s checkout editor: test it in a real checkout. It also does nothing where Shopify doesn’t let the checkout change, such as discount codes on an invoice for a draft order. See automations.

Custom fields forms

For a form made with Custom fields, check these in order:

Is the form published? Its Status card should say Published. New forms start as Draft.
Is the Custom fields app block in checkout, and saved? Forms show in their own Custom fields app block, not the Checkout Buddy (v1) one. Add it in Shopify’s checkout editor, then save the editor.
Does the app block have Block IDs? If it lists IDs, it only shows those forms. The form’s ID is under Status in its editor.
Do the conditions match? Check Who sees it. A condition about payment, the address or the delivery option counts only once the customer has chosen it.
Is a field missing from the form? A field set to Show this field → Only when… stays hidden until the other field has the answer it needs. The form’s Preview shows the rule working.
Does a required field let customers through? Required fields stop checkout only with Allow app to block checkout on in the app block’s settings. Express checkouts like Shop Pay and Apple Pay skip the form: see checkout rule for a required checkbox.

A form also doesn’t show in a checkout where Shopify doesn’t let apps save cart attributes, since there’d be nowhere to save the answers.

Thank you page blocks

For a block made on the Thank you tab, check these in order:

Does its place have the app block? For blocks on the page, the announcement bar, the header or the footer: in Shopify’s checkout editor, switch to the Thank you page and check that the Thank you page app block (under Checkout Buddy) is in the block’s place. Add it there and click Save. If you haven’t hidden the setup guide on the Thank you tab, its last step names places with blocks that are missing it. Blocks under the customer information or the items need no app block: skip this step for them.
Do the conditions match? In Shopify’s editor, the app block shows a note, Checkout Buddy (only you see this), when blocks are hidden because their conditions don’t match the order the editor previews with. In Checkout Buddy, the block’s Preview shows which conditions hide it for each sample order.
Does the app block have Block IDs? If its Block IDs setting lists IDs, it only shows those blocks, and only ones made for its place. Add the block’s ID from the ID column, or leave Block IDs empty to show every block for the place. See block IDs.
Is the block published? Its Status card should say Published. Drafts only show in the preview.
Does the block have something to show? Product offers hide when every product is sold out or recommendations return nothing; a Discount code hides when its code is empty; an Order guide hides when no product in the order has a value. See thank you page.

Only one announcement shows per page, and item notes only show under items that match their This item conditions. On Shopify Starter, the thank you page doesn’t show app blocks.

Customer account blocks

For a block on the Profile, Orders or Order status page, in the announcement bar, in the footer or in the company profile, check these in order:

Does the page have the app block? Open the Active configuration in Shopify’s checkout and accounts editor, then the Apps panel (the apps icon at the top left), and choose Added. It lists every Customer accounts app block you’ve added, with its page underneath. If it isn’t, add it where the block should show (the page, its announcement bar or the footer) and click Save.
Do the conditions match? In Shopify’s editor, the app block shows a note, Checkout Buddy (only you see this), when blocks are hidden because their conditions don’t match the customer the editor previews with. In Checkout Buddy, the block’s Preview shows which conditions hide it for each sample customer.
Does the app block have Block IDs? If its Block IDs setting lists IDs, it only shows those blocks, and only ones made for its page. Add the block’s ID from the ID column, or leave Block IDs empty to show every block for the page. See block IDs.
Is the block published? Its Status card should say Published. Drafts only show in the preview.
Are customer account blocks turned on? In the Settings card on the Customer accounts tab, Show Checkout Buddy blocks in customer accounts should be on.

Order button and company profile blocks need no app block, because Shopify shows them on its own, so for those, skip steps 1 and 3. Company profile blocks only show to B2B customers. On Shopify Starter, customer accounts don’t show app blocks. See customer accounts for which blocks each place shows.

Older blocks and Cart line item blocks

Checks 1 to 8 are for blocks in the Checkout Buddy (v1) and Cart line item app blocks: blocks made before the Content block, and Cart line editor, Line item text and Line item upsell. Work through them in order: most missing blocks are fixed by one of the first four.

1. Is the block enabled?

On Customizations, the block’s status should be Enabled. If it says Disabled, open it, turn on Status, then save.

2. Is it placed in the Checkout Editor, and saved?

Creating a block doesn’t put it in checkout. Go to Settings → Checkout in Shopify admin, click Edit next to your active configuration, and check there’s a Checkout Buddy (v1) app block where you expect it, or a Cart line item app block under the items in the order summary for a Cart line editor, Line item text or Line item upsell. Then click Save in the Checkout Editor. Unsaved Checkout Editor changes don’t reach your live checkout.

Make sure you’re editing the live checkout configuration if you have more than one. See add your first block.

3. Does Fixed block ID match?

In the app block’s settings, Fixed block ID (or Multiple block IDs) must contain the block’s number from the ID column on Customizations. Check for typos, and for IDs of blocks you’ve since deleted.

4. Do the conditions pass?

Open the block and look at Conditions. Temporarily switch to Show for all orders. If the block then appears, one of the conditions is the problem. Common causes:

Money conditions and currencies. Block conditions compare against the amount in the customer’s currency. See markets and currencies.
“is more than” is strict. “Cart subtotal is more than 50” doesn’t pass at exactly $50. Use 49.99.
Conditions that look at information the customer hasn’t entered yet, such as shipping country before the address is filled in.
Customer conditions for guests. Customer account exists only passes for logged-in customers.
Conditions added in one go are combined with OR, not AND. See common mistakes.

5. Is it limited to certain markets or devices?

Markets: with Apply to selected markets only, customers in other markets don’t see it. Test from the right country, or use Shopify’s market preview.
Devices (Image and older Product offers): with Show on selected devices only, it’s hidden on other devices.

6. Does the block have something to show?

Some blocks hide themselves when there’s nothing to show:

Older Product offers: every product is sold out, already in the cart, or unavailable in the customer’s market. Recommendations may return nothing, and the block also hides when the checkout doesn’t allow adding products.
Line item upsell: the product has no subscription plans, or no complementary products.
Cart line editor’s Subscribe button: the product has no subscription plans, or the item is already a subscription. Add-on button: the product has no complementary products, or one is already in the cart. Both only show in the Cart line item app block.
Older progress bars: Target is empty.
Line item text, Cart line editor, Line item upsell: not placed under the line items.

7. Is it on the right page?

The Checkout Editor places blocks per step: Information, Shipping, and Payment. A block placed on the Shipping step won’t show on Information. One-page checkouts show all sections on one page.

Checkout blocks you placed on the thank you page show only when the Block IDs of a Thank you page app block list them. See checkout blocks on the thank you page. For blocks made on the Thank you tab, see thank you page blocks.

8. Is your store on Shopify Plus?

Checkout blocks need Shopify Plus, because Shopify shows app blocks on checkout’s steps only on Plus stores. If your Shopify plan changed, they stop showing, and Customizations shows a Needs Shopify Plus warning. Development and Plus sandbox stores work.

Product offers on product and cart pages, thank you page blocks and customer account blocks don’t need Plus. They show on every Shopify plan except Starter.

Still not showing?

Email kyle@keylayapps.com with your store address, the block ID, and a screenshot of the app block’s settings in the Checkout Editor, or of the Product offers block in Shopify’s theme editor.