Quick checks
Run through these common causes before diving into detailed troubleshooting:
Check | Fix |
Verifier status is set to Draft | Set it to Active in Address Validation settings. |
Checkout block not installed | Add the Address Validation block in the Shopify checkout editor. |
Usage charges not configured | Click Configure usage charges to accept pay-per-use billing. |
Usage cap reached | Click Adjust usage cap and increase your monthly limit. |
Checkout not published | Save and publish your checkout in the Shopify checkout editor. |
Detailed troubleshooting
Verifier is in Draft status
A verifier must be set to Active to validate addresses. Draft verifiers are saved but don't run.
1. Go to Address Validation in the Order Editing app.
2. Check the status indicator next to your verifier name. A green dot means Active.
3. If it's in Draft, click the edit icon and change the status to Active.
4. Save.
Address Validation block not installed in checkout
The Address Validation block needs to be added in the Shopify checkout editor. Without it, validation has nowhere to display.
1. Go to Shopify admin > Settings > Checkout.
2. Click Customise.
3. Look for the Address Validation block in the checkout layout. You should see a green "Address validation will appear here" placeholder.
4. If it's missing, click Add block, find the OrderEditing.com group, and add the Address Validation block.
5. Save your checkout.
Usage charges not configured
You need to accept Shopify's usage-based billing before verifiers can run. Without this, the verifier can be saved but won't process any addresses.
1. Go to Address Validation and click Create verifier (or edit an existing one).
2. If you see a yellow banner saying "Usage-based subscription required", click Configure usage charges.
3. Follow the Shopify prompts to approve.
Monthly usage cap reached
When your monthly spending cap is reached, verification pauses automatically. Checkout continues to work, but addresses are not validated.
1. Check the Address Validation dashboard for your current usage.
2. Click Adjust usage cap.
3. Increase the cap to resume verification.
Shipping country not covered by verifier
Verifiers only validate addresses for the countries you've selected. If a customer ships to a country that isn't covered, no validation runs.
1. Edit your verifier.
2. Check the Countries field.
3. Add any missing countries you ship to.
4. Save.
Verification conditions are filtering out the address
If you've added verification conditions, they may be excluding the address you're testing with.
1. Edit your verifier and go to Advanced Settings > Verification Conditions.
2. Check whether you're in "Skip verification" or "Run verification only" mode.
3. Review your conditions to make sure they aren't excluding the test address.
4. To test without conditions, temporarily remove all conditions and save.
Checkout validation requires Shopify Plus
Validation at checkout (before purchase) requires Shopify Plus with checkout extensibility. If you're not on Plus, validation will only run on the Thank You page and Order Status page after purchase.
Make sure your verifier's Surface Settings are set to include post-purchase if you're not on Shopify Plus.
Error rules not blocking checkout
If you've set a validation rule to "Error (Blocks Checkout)" but it's not blocking, the permission hasn't been enabled in Shopify.
1. Go to Shopify admin > Settings > Checkout > Customise.
2. Click the Address Validation block in the sidebar.
3. Under Checkout behavior, turn on Allow app to block checkout.
4. Save your checkout.
Still not working?
Enable debug logs to investigate further. In the checkout editor, click the Address Validation block, set Enable logs to True, and check the browser console during a test order. See Testing your Address Validation setup for details.
Start a live chat from within the Order Editing app. Include your store URL, a screenshot of the issue, and a description of what you've tried.