Skip to content
On this page
Fix Troubleshooting 1 min read Updated Sep 28, 2026

Error message not blocking checkout

In short

Shopify only lets an app stop buyers if you allow it. Select the Rules Executor in the checkout editor, allow it to block checkout progress and save.

✓ Applies to

  • Rules with a Show Error Message action
  • Rules with a Validate Via API action that returns errors
  • Shopify Plus checkout (and development stores)

✕ Doesn't apply to

  • Required fields in Custom Blocks
No error appears at all? Start with the rule checklist →
Without this permission, Shopify ignores the error and lets buyers through

Check these in order

  1. Blocking not allowed → select the Rules Executor, allow it to block checkout progress, click Save. Test in a new checkout. Got several executors? Allow it on each.
  2. Executor on an earlier step → on three-page checkout it only blocks on its own step. Put it on the step where the buyer enters the data, or later, and allow blocking there too.
  3. Rule stops matching → the error clears once the buyer changes what the rule checks. That’s expected. With All conditions, every one must match. All conditions.
  4. API reply is invalid (Validate Via API) → a failed call or missing actions array blocks nothing. Check the call in your browser’s network tab.
  5. No error at all → the rule isn’t running. Rule checklist.

A valid API reply

Always include actions, even when empty. The HTTP status code doesn’t matter.

{
  "actions": [],
  "errors": [{ "message": "We can't deliver to this postcode.", "target": "$.cart.deliveryGroups[0].deliveryAddress.zip" }]
}

Full contract.

i

Anything that completes the order without loading the page with the executor isn’t checked.

Frequently asked

Why does Shopify need my permission to block checkout? +

It's a Shopify safeguard. An app can ask to block checkout progress, but only the merchant can allow it, per app block, in the checkout editor.

When does the buyer see the error? +

When they try to continue while the rule matches. Checkout stays on the current step until they change what the rule checks.

Can a buyer skip the error with an express checkout button? +

The Rules Executor only runs on the checkout page where you placed it. Anything that completes the order without loading that page isn't checked.

Related guides

Still stuck? Open the app and use Support to chat with the team, or contact us. Don't have the app yet? Install Checkout Ninja.