Before you begin
Content blocks live on the Content page. Open the Shopify admin, go to Apps > Order Editing, then select Content.
There are two ways to use a block:
Content block: a block with its own audience, markets, and schedule. It shows in a Content Block app block on the Checkout or Thank you page, with no product offers.
Saved block: a reusable block you add to one or more upsell strategies, so it shows next to their product offers.
A Checkout page block needs Shopify Plus. Without Plus, choose the Thank you page.
Content blocks appear in every language your store publishes. To change a block's text and images for one language, use Language in the block's title bar. See How to translate a content block.
Choose a template
Template | Best for |
|---|---|
Campaign image | One wide image for a collection, sale, or announcement, with an optional link. |
Trust badges | Icon rows for reviews, quality, and flexible policies. |
Subscription benefits | Compact perk lists for selling-plan offers. |
Included in your order | A feature checklist with a shared checkmark colour. |
Purchase reassurance | Returns and exchange policy points with a heading and icons. |
Featured review | One strong quote with stars and an author. |
FAQ | Expandable questions that clear common objections. |
Rewards bar | Live checkout progress toward configured cart goals. The actual reward needs its own discount or shipping rule. |
Payment icons | A row of branded payment logos, with optional labels next to each method. |
Several templates have their own guide, such as How to use the Campaign image content block and How to use the FAQ content block. Use this guide for Purchase reassurance and the shared workflow.
Create a content block
Open Content and select Create content.
Choose a template, then choose where it shows: Checkout or Thank you page. Select Continue.
In Block details, enter a Block name or select Generate. Only you see this name.
Check the Slot. A new block takes the next free slot. The next section explains slots.
In Content, select Customize to edit the block's text, images, rows, and appearance. The preview on the right updates as you go.
Choose the Markets and customers who see it. Leave All customers selected, or select Add customer filters.
Optionally, set a Schedule with a start and end date.
Check the Summary card. It lists the filters, markets, and slot, and its Reach row shows roughly what share of orders the filters match.
Select Publish block (or Schedule block when the start date is in the future). Select Save as draft to keep it off.
A banner at the top lists anything left to finish. Starter text from the template can't be published, so replace it first.
Put the block on the page
Each Content Block app block in Shopify's checkout editor has a Slot setting from 1 to 8. A content block set to Slot 2 shows in the app block set to Slot 2, so several blocks can show on one page.
After you publish, select Open checkout editor in the Last step banner.
On the Checkout or Thank you page, select Add block and choose Content Block.
Set its Slot to the block's slot number, then save the checkout editor.
Repeat for each slot you use.
If two live blocks use the same slot, only one shows. The one with more specific customer filters wins, then the one for fewer markets, then the older block. The block that loses tells you which block is hiding it.
A Content Block app block with its Slot left empty shows blocks that have no slot.
Locked by ID is the last option in the Slot menu, for older setups. Select Copy strategy ID, then paste the ID into the app block's Locked Strategy field. A Locked Strategy ID wins over the Slot.
Older blocks with no slot
When older blocks have no slot, the Content page shows an Assign slots card. Use it to give each block its own slot, then add one Content Block app block per slot in the checkout editor. You can also keep them sharing one place, where shoppers see one block at a time.
Edit, pause, or archive a content block
Open the block from the Active, Drafts, or Archived tab on Content. Change what you need and save.
To pause a block, set its status to Draft.
To stop showing it and keep its results, choose Archive from the status menu. Restore it later from the Archived tab.
Content blocks have no Delete or A/B test. The Content page shows Content views, Content interactions, Interaction rate, and Active content for the date range you choose, with a daily chart.
Create a saved block for upsell strategies
Open Content, select the Saved blocks tab, then select Create saved block.
Choose a template and customise it.
In Status, choose Active or Draft.
Set Show on to All devices, Mobile, or Desktop. This follows the shopper's device. Browser width and zoom don't change which blocks appear.
Select Save block.
To put a saved block live:
Open it from Saved blocks and select Show this block.
Choose Checkout or Thank you. Order Editing creates a draft strategy that holds the block and opens it, ready to publish.
Or select Use existing strategy to add it to a strategy that can show it. Active strategies are listed first.
Publishing the strategy also turns on the block if it was a draft. Used by on the block's page lists every strategy that uses it. Duplicate and Delete are in the title bar. Delete is off while a strategy uses the block, so remove it from every strategy first.
Add a saved block inside a strategy
Open an upsell strategy.
Under Offer layout, select Add content block.
Choose a saved block or a template.
Drag the block before or after the product offers, or into the product pop-up. You can also focus the drag handle and use the keyboard.
Save the strategy. The block isn't added until the strategy is saved.
Editing a saved block updates every strategy that uses it. Duplicating a strategy creates independent copies of its blocks, so editing the copy doesn't change the original.
For supported offer-list blocks, turn on If there are no products, continue to show the content block when the content should stay visible after the product modules return no eligible products. Placement, market, audience, and status checks still apply.
Add images
Image fields offer two ways to add a picture:
Select from Shopify Files (or Replace) opens Shopify's file picker.
The upload icon uploads an image from your device. Uploads accept JPG, PNG, or WebP images up to 10 MB. They're hosted by Order Editing and aren't added to Shopify Files. If an upload fails, your existing image stays in place.
Enter meaningful alt text when an image carries information. Select This image is decorative only when it adds none. Links in a content block open in a new tab.
Preview the block
Check the Preview card on the block's page.
Open the checkout editor for the page the block shows on and confirm it appears in the right app block.
To check a saved block set to Mobile or Desktop, turn the app block's Preview Mobile setting on or off. The checkout editor always reports a computer, so this is how you see the phone result there. Shoppers are matched by their own device.
Move blocks between stores
On Saved blocks, use Export blocks and Import blocks to copy reusable content. Review each imported block before you use it, especially images, links, and status. A copied block doesn't add the app block in the checkout editor or connect an integration.