Make sure you've completed the setup in Setting up Address Validation and have at least one verifier saved (it can be in Draft or Active status).
Every verifier has a built-in preview that shows exactly what your customers will see at checkout. You don't need to place a test order to check how each verification state looks.
Go to Address Validation and click the edit icon on your verifier.
On the right side of the page, find the Preview panel.
Use the tabs to cycle through each verification state:
Tab | What it shows |
Verified | Green confirmation banner: "Your address has been validated and is correct." |
Suggestion | Yellow banner with a corrected address and "Use corrected address" / "Keep my address" options. |
Clarification | Yellow banner asking the customer to check specific fields (e.g. street number, apartment). |
N/A | Yellow banner indicating the address couldn't be verified, with a "Keep my address" option. |
This preview reflects your current settings, including any customised messages you've set in Translations.
When you create or edit a validation rule, the Rule Coverage widget shows you how many of your recent orders would have triggered that rule. This lets you test rules against real data before going live.
Go to Address Validation and click Create validation (or edit an existing rule).
Add at least one trigger.
Check the Rule Coverage widget in the top right corner. It shows:
Percentage. What portion of your recent orders would have triggered this rule.
Order count. The exact number (e.g. "6 of 99 recent orders").
Date range. The 30-day window used for the estimate.
Click the percentage to open the Affected Orders list. This shows every order that would have triggered the rule, along with orders that wouldn't have. You can review the city, country, and postal code for each.
Click Re-test to refresh the estimate after changing triggers.
ℹ️ Note: Some triggers can't be estimated from historical data. Triggers that check address text (like "Field Contains Text" or "Field Contains Special Characters") will show a Partial estimate badge. The coverage may be higher or lower than shown, but the rule will still work correctly at checkout.
You can see where Address Validation appears in your checkout layout without placing an order.
Go to Shopify admin > Settings > Checkout.
Click Customise next to your checkout configuration.
Look for the green banner: "Address validation will appear here." This shows the exact position where validation banners will display to customers.
Use the checkout editor to reposition the Address Validation block if needed.
If you need to troubleshoot whether validation is firing correctly, enable logging in the checkout editor.
In the checkout editor, click the Address Validation block in the sidebar.
Under Block settings, set Enable logs to True.
Save your checkout.
Place a test order and open your browser's developer console (usually F12 or right-click and select "Inspect").
Look for Address Validation log entries. These show when validation runs, what result it returns, and any errors.
⚠️ Warning: Remember to set Enable logs back to False before going live. Logs are visible to anyone who opens the browser console on your checkout.
The best way to confirm everything works end to end is to place a real test order.
Make sure your verifier is set to Active.
Go to your online store and add a product to the cart.
At checkout, enter a shipping address with a deliberate typo (e.g. misspell the street name or city).
Confirm you see a suggestion or clarification banner below the address fields.
Complete the purchase and check the Thank You page for a post-purchase suggestion (if you've enabled post-purchase validation).
Click through to the Order Status page and confirm the "Suggestion available" badge appears next to "Edit delivery address."
💡 Tip: Use Shopify's Bogus Gateway to place test orders without processing real payments.
Check | Expected result |
Enter a valid address at checkout | Green "validated and correct" banner appears. |
Enter a misspelled address at checkout | Yellow suggestion banner with corrected address appears. |
Complete purchase with a flagged address | Thank You page shows address correction option (if post-purchase is enabled). |
Visit Order Status page | "Edit delivery address" shows "Suggestion available" badge. |
Validation rule triggers (if configured) | Rule message appears below the address fields with the correct severity (info, warning, or error). |
If validation isn't appearing, see Why isn't Address Validation triggering? for common causes and fixes.
Start a live chat from within the Order Editing app if you need help. Include your store URL, a screenshot of the issue, and a description of what you've tried.
