---
title: "Testing Address Validation Setup"
description: "How to verify Address Validation is working correctly before going live."
url: https://docs.orderediting.com/en/articles/14246702-testing-address-validation-setup
collection: "Getting Started"
updated: 2026-09-28
language: en
---

# Testing Address Validation Setup

How to verify Address Validation is working correctly before going live.

# Before you begin

Make sure you've completed the setup in [Setting up Address Validation](/docs/en/articles/14246659-getting-started-with-address-validation) and have at least one verifier saved (it can be in Draft or Active status).

# Use the verifier preview panel

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.

1.  Go to **Address Validation** and click the edit icon on your verifier.
    
2.  On the right side of the page, find the **Preview** panel.
    
3.  Use the tabs to cycle through each verification state:
    

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Tab</strong></p></th><th colspan="1" rowspan="1"><p><strong>What it shows</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p><strong>Verified</strong></p></td><td colspan="1" rowspan="1"><p>Green confirmation banner: "Your address has been validated and is correct."</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Suggestion</strong></p></td><td colspan="1" rowspan="1"><p>Yellow banner with a corrected address and "Use corrected address" / "Keep my address" options.</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>Clarification</strong></p></td><td colspan="1" rowspan="1"><p>Yellow banner asking the customer to check specific fields (e.g. street number, apartment).</p></td></tr><tr><td colspan="1" rowspan="1"><p><strong>N/A</strong></p></td><td colspan="1" rowspan="1"><p>Yellow banner indicating the address couldn't be verified, with a "Keep my address" option.</p></td></tr></tbody></table>

This preview reflects your current settings, including any customised messages you've set in [Translations](/docs/en/articles/14246887-customising-validation-messages-and-translations).

# Test validation rules with Rule Coverage

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.

1.  Go to **Address Validation** and click **Create validation** (or edit an existing rule).
    
2.  Add at least one trigger.
    
3.  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.

1.  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.
    
2.  Click **Re-test** to refresh the estimate after changing triggers.
    

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.

# Preview in the checkout editor

You can see where Address Validation appears in your checkout layout without placing an order.

1.  Go to **Shopify admin > Settings > Checkout**.
    
2.  Click **Customise** next to your checkout configuration.
    
3.  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.

# Enable debug logs

If you need to troubleshoot whether validation is firing correctly, enable logging in the checkout editor.

1.  In the checkout editor, click the **Address Validation** block in the sidebar.
    
2.  Under **Block settings**, set **Enable logs** to **True**.
    
3.  Save your checkout.
    
4.  Continue to checkout and open your browser's developer console (usually F12 or right-click and select "Inspect").
    
5.  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.

# Check each selected rule page

For each custom rule, review **Where this rule applies**. Test **Checkout**, **Thank-you page** and **Order status page** separately if selected. Confirm a matching address shows the message and a valid address does not.

You can test checkout messages before payment. Use an existing eligible order for Order Status behavior. Create a new controlled order only when you need to verify the immediate Thank You journey, which an existing checkout cannot replay.

An after-purchase message cannot block checkout. Test blocking only on Checkout with the required Shopify permission.

# Place a test order

The best way to confirm everything works end to end is to place a real test order.

1.  Make sure your verifier is set to **Active**.
    
2.  Go to your online store and add a product to the cart.
    
3.  At checkout, enter a shipping address with a deliberate typo (e.g. misspell the street name or city).
    
4.  Confirm you see a suggestion or clarification banner below the address fields.
    
5.  Complete the purchase and check the **Thank You page** for a post-purchase suggestion (if you've enabled post-purchase validation).
    
6.  Click through to the **Order Status page** and confirm the "Suggestion available" badge appears next to "Edit delivery address."
    

Use Shopify's [Bogus Gateway](https://help.shopify.com/en/manual/checkout-settings/test-orders) to place test orders without processing real payments.

# What to check

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p><strong>Check</strong></p></th><th colspan="1" rowspan="1"><p><strong>Expected result</strong></p></th></tr><tr><td colspan="1" rowspan="1"><p>Enter a valid address at checkout</p></td><td colspan="1" rowspan="1"><p>Green "validated and correct" banner appears.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Enter a misspelled address at checkout</p></td><td colspan="1" rowspan="1"><p>Yellow suggestion banner with corrected address appears.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Complete purchase with a flagged address</p></td><td colspan="1" rowspan="1"><p>Thank You page shows address correction option (if post-purchase is enabled).</p></td></tr><tr><td colspan="1" rowspan="1"><p>Visit Order Status page</p></td><td colspan="1" rowspan="1"><p>"Edit delivery address" shows "Suggestion available" badge.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Validation rule triggers (if configured)</p></td><td colspan="1" rowspan="1"><p>Rule message appears below the address fields with the correct severity (info, warning, or error).</p></td></tr></tbody></table>

# Still not working?

If validation isn't appearing, see [Why isn't Address Validation triggering?](/docs/en/articles/14246934-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.

## Related

- [What Is Address Validation](https://docs.orderediting.com/en/articles/14246443-what-is-address-validation.md)
- [Getting Started with Address Validation](https://docs.orderediting.com/en/articles/14246659-getting-started-with-address-validation.md)