If Shopify checkout validation is not working, first reproduce the failure with one known matching cart. Then check the rule's saved status, evaluation scope, input, operator, and condition values before changing anything else. If the rule works in standard checkout but not Shop Pay, verify that the CartBlock checkout app block is included in Shop Pay on an eligible Shopify Plus store.

Changing several settings at once makes the cause harder to find. Work through this checklist in order.

Before you start, record the rule ID, build one privacy-safe test cart, and capture redacted screenshots of the rule summary and visible error. This gives you a baseline and prevents a later change from erasing useful evidence.

1. Confirm Shopify checkout validation is active

Open CartBlock and verify that you are viewing the current rule, not an older draft or duplicate. Check the generated rule summary against the policy you intended to enforce.

Re-save only after you have recorded the current configuration. If a rule was created in an older version, review the Help Center's current migration guidance before rebuilding it.

2. Create one controlled test cart

Choose a simple case that should definitely match:

  • One known product or product tag.
  • One exact quantity threshold.
  • One test customer or country.
  • One standard checkout path.

Write down the expected outcome. Test a matching case and a non-matching control case. If both behave the same way, the problem is likely scope, configuration, or installation rather than an edge case.

3. Check the validation scope

CartBlock's current tutorials describe three scopes: cart interaction, checkout completion, and interaction within checkout. A rule evaluated only at one point may not appear where you expected.

Confirm that the selected scope matches the shopper action you are testing. Do not assume a checkout message also appears on the product page or cart drawer.

4. Verify the function input and condition

Check each part of the rule. The function input is simply the Shopify data the validation reads, such as cart lines, customer tags, or an address field.

  • Is the selected input appropriate for the product, cart, customer, address, shipping, or payment field?
  • Is the operator reversed, such as any instead of not any?
  • Does the selected product, tag, collection, country, or method still exist?
  • Is a quantity threshold off by one?
  • Does the value include unexpected capitalization or spacing?

Use the rule summary as a plain-language test. If you cannot explain exactly when it fires, simplify the rule temporarily.

5. Review AND and OR logic

With AND, every grouped condition must match. With OR, any grouped condition can match. A single wrong connector can make a rule appear inactive or make it too broad.

Reduce a complex rule to one condition. Confirm it works, then add one condition at a time and retest matching and non-matching carts.

6. Check the CartBlock checkout app block

Some checkout workflows require an app block or related checkout-editor setting. Confirm the CartBlock block is present where the current setup guide requires it and that any rule ID or synchronization setting is correct for the feature.

Shopify checkout validation overview explains that validations run on Shopify servers and can block order completion when business rules fail. Its Function API reference lists supported surfaces and inputs. Use those references for the platform boundary, then use CartBlock current guide for configuration.

For payment-method rules, for example, the current owned workflow documents a Sync Payment Method setting and Shopify Plus eligibility. Follow the exact feature guide rather than copying settings from another rule type.

7. If it fails only in Shop Pay, enable the block there

CartBlock's Shop Pay troubleshooting guide says checkout app blocks are not automatically included in Shop Pay.

For an eligible Shopify Plus store:

  1. Go to Settings → Checkout in Shopify admin.
  2. Open the checkout editor.
  3. Select the CartBlock app block.
  4. Enable Include block in Shop Pay under checkout behavior.
  5. Save and preview Shop Pay.

The owned guide states that Shop Pay support for checkout extensions is Shopify Plus-only. Recheck current Shopify and CartBlock eligibility before publication or launch.

8. Separate draft-order behavior from storefront checkout

Draft orders and their checkout links can follow a different creation path from a shopper-built storefront cart. Do not assume every cart validation receives the same inputs in a draft-order workflow.

Reproduce the problem once through the normal storefront and once through the draft-order link. Then consult the current CartBlock draft-order FAQ or Nextools support with the rule ID, store plan, checkout path, and test result.

9. Test after theme, checkout, or rule changes

Use a fresh private session to avoid a stale cart or customer state. Test on mobile and desktop, and include any accelerated checkout used by the store.

After a Shopify or app update, verify the live interface rather than relying on an old screenshot. Record the test date and the exact path that passed.

Quick diagnostic table

Symptom First check
Never triggers Saved status, scope, input, and operator
Triggers for the wrong shoppers AND/OR grouping and any/not any
Works in standard checkout, not Shop Pay Include block in Shop Pay
Works for one product, not another Product, tag, or collection membership
Fails at a quantity boundary Greater-than vs. greater-than-or-equal logic
Fails only for draft orders Draft-order support and available inputs
Payment rule sees no selected method Required app block and sync setting

What to send support

If the rule still fails, send Nextools support:

  • The rule title or ID.
  • A screenshot of the full rule summary without customer data.
  • Shopify plan and CartBlock plan.
  • Standard checkout, Shop Pay, or draft-order path.
  • Exact cart contents and expected result.
  • Timestamp and store time zone.
  • Whether the non-matching control test passed.

This evidence helps distinguish rule logic from checkout-path or entitlement issues.

Link the symptom to the matching setup

Frequently asked questions

Why does CartBlock work in checkout but not Shop Pay?

The current owned guide says the app block must be explicitly included in Shop Pay for eligible Shopify Plus stores.

Why did my rule stop after a product change?

Check whether the rule uses a product ID, product tag, variant, or collection whose membership changed.

Should I rebuild the rule immediately?

No. Record the current configuration, isolate the failing condition, and check migration guidance first. Rebuilding too early can remove evidence of the cause.

Fix Shopify checkout validation one variable at a time

Start with a controlled matching cart, check scope and logic, and then test alternate checkout paths. If you need a configurable validation workflow, explore CartBlock on the Shopify App Store or use the in-app support channel with the diagnostic details above.