Skip to content
CheckoutStack

Docs

Setup takes about five minutes.

Install, write, preview, save. Everything below is the whole of it.

  1. 01

    Install the app

    From the Shopify App Store, on the store you want to edit. CheckoutStack asks for three scopes: read markets for per-market targeting, and read and write files so the image picker can browse and upload to your own Shopify Files. Block content lives in the app's own metafields and needs no scope at all.

  2. 02

    Create a block

    Pick a type, write your copy, and watch the preview beside the form. The preview is the real block built from the real form state, so what you are looking at is what the buyer gets. New blocks default to the Under payment position, which renders on every checkout.

  3. 03

    Narrow it with display rules

    Add conditions so the block only appears on the carts it is meant for. Match on all conditions or any of them. Rules are evaluated live inside checkout, so a cart-total rule re-checks the moment the buyer changes their cart.

  4. 04

    Save, and it is live

    Saving republishes every enabled block to a single Shopify metafield that your checkout reads directly. There is no theme publish, no cache to clear and no deploy. Disabled blocks are stripped out entirely.

Custom positions

Six positions render automatically. The seventh lets you put a block anywhere the Shopify checkout editor allows an app block, which is the escape hatch for every layout the fixed targets do not cover.

  1. Open the checkout editor in your Shopify admin. Settings, then Checkout, then Customize.
  2. Add the CheckoutStack app block where you want it. Drag it into the section of the checkout you are targeting.
  3. Copy its Block ID. The ID is in that app block’s own settings panel on the right.
  4. Paste it into your block in CheckoutStack. Set the position to Custom and paste the ID. Several IDs can share one block, separated by commas.

When a block is not showing up

In order of how often it turns out to be the cause.

The block saved but nothing appears in checkout

Check the position first. Above the shipping address and Under shipping methods do not render on digital-only carts, because those carts have no address or delivery step at all. Order summary positions sit inside the summary, which is collapsed by default on mobile. Under payment renders on every checkout and is the safest place to test with.

It works on my test cart but not a real one

That is almost always a display rule. Open the block, set matching to all conditions, and remove rules one at a time until it appears. Rules read live checkout signals, so a rule on a field the cart does not have evaluates as empty rather than true.

Shipping province, customer email or logged-in rules never match

Those three fields need Shopify's protected customer data approval on your app. Until it is granted they evaluate as empty by design. Every other rule field works without it.

I am not on Shopify Plus and see nothing on the checkout steps

Shopify restricts checkout UI extensions on the information, shipping and payment steps to Shopify Plus. Thank-you page blocks are not restricted and work on every plan. This is a platform limit, not a CheckoutStack setting.

My custom-position block is not rendering

A custom position needs two halves. Drag a CheckoutStack app block into place in the checkout editor, copy the Block ID from its settings, and paste that ID into the block's Block ID field in the app. One app block can take several IDs, separated by commas.

The metafield write failed with a red banner

That banner carries the exact error Shopify returned. It usually names a missing scope. Reinstall the app to accept the updated scopes, then save the block again.

Still stuck after all that?

Send the store URL and the block you are working on. Replies land within one business day.

Contact supportOpen the app

Prefer to read on? Every feature in detail