Introduction to Checkout Studio
Pages, positions, adding blocks, when to show them and the one-time step in Shopify.
Checkout Studio lets you add extra blocks to your checkout, Thank you page and Order status page, with an instant preview. You design the block in the app, then place it once in the Shopify checkout editor. This guide explains how Checkout Studio works.
1. Open Checkout Studio
Open Checkout UI extension from the app menu.
2. Choose the page
Use the page menu to choose where to work:
- Checkout – Information, Shipping, Payment, or Single page.
- Thank you
- Order status
Information, Shipping and Payment blocks show only on Shopify Plus stores. Thank you and Order status blocks work on every plan.
3. Understand the positions
Each page has places where a block can go, for example Top of page, After contact, After delivery options, Payment area, Above the pay button, After cart items, Under each cart item, Below discount code, Footer and Below the total. Each position holds up to 3 blocks (up to 6 under each cart item).
4. Add a block
- Hover any spot on the preview and press Add block.
- Pick a block from the list. Blocks are grouped as Content, Icons & badges, Forms & fields, Product upsell and Cart line. Blocks that need a higher plan show Upgrade to ... to use. Some blocks can be added only once.
- Click the block to edit it. The Blocks on this page list helps you find any block.
- Use Desktop or Mobile to check the preview.
- Click Save. A message says Checkout blocks saved.
5. Choose when a block shows
In a block's settings, set Display:
- Always – the block shows to everyone.
- On trigger – the block shows only when your conditions match, for example a cart subtotal above an amount or a country. When they do not match, it leaves no empty space.
Conditions use the same list as checkout validations, see Conditions.
6. Place the block in Shopify (one-time step)
Banner, Benefits, Trust badges, Payment icons, Social icons, Policy checkbox, Warranty and Custom blocks are placed by hand in Shopify:
- Open the Shopify Checkout editor (for the Thank you page, open the Thank you page first).
- Click Add block and choose Checkout Blocks.
- In the block's Block name field, type the exact name of your block from Checkout Studio. Without a name nothing shows.
- Drag the app block to the same position you picked in Studio.
For the position Below the total, place one app block in Shopify: Checkout editor > Order status page > Order summary > Add block > Order Status Upsell. That one block shows every block you add in Studio there.
Tips
- Keep checkout simple: three or four well-chosen blocks work better than many.
- Always check the Mobile preview.