--- title: "Getting Started with Address Validation" description: "Step-by-step guide to configuring address verification and validation rules for your store." url: https://docs.orderediting.com/en/articles/14246659-getting-started-with-address-validation collection: "Getting Started" updated: 2026-10-16 language: en --- # Getting Started with Address Validation Step-by-step guide to configuring address verification and validation rules for your store. # What is Address Validation? Address Validation catches shipping address errors before orders are fulfilled. It reduces failed deliveries, lowers return rates, and cuts address-related support tickets. It uses two systems that work together:

System	What it does	Cost
Verifiers	Check addresses against official postal databases (powered by Experian) across 195+ countries. Confirm the address is real and deliverable.	Pay per validation, starting at $0.01 USD.
Validation rules	Run instant format checks in the browser as customers type. Catch missing house numbers, restricted regions, special characters, and more.	Free, unlimited use.

Validation rules run first to catch formatting issues (free). Once those pass, verifiers check the address against postal data (paid). Together, they give customers real-time feedback without slowing down checkout. For a full breakdown of how it works, features, and pricing, see [What is Address Validation](/docs/en/articles/14246443-what-is-address-validation). 🔒 **Shopify Plus:** Checkout validation (where customers see suggestions before they pay) requires Shopify Plus with checkout extensibility. Post-purchase validation on the Thank You Page and Order Status Page works on all Shopify plans. # Step 1: Accept usage-based billing Verifiers are billed per validation through Shopify. You need to accept usage charges before you can publish a verifier. 1. In the Order Editing app, go to **Address Validation**. 2. Click **Create verifier**. 3. You'll see a yellow banner: "Usage-based subscription required." Click **Configure usage charges**. 4. Follow the Shopify prompts to approve the usage charge. ![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_9501.png) Shopify bills you when you reach $200 in usage. Each charge is transparent, and you can see exactly which addresses were validated in your Shopify admin under **Settings** > **Billing**. # Step 2: Set your usage cap The usage cap is your maximum monthly spend on address verification. It protects you from unexpected costs. 1. On the **Address Validation** dashboard, click **Adjust usage cap**. 2. Use the slider to set your monthly budget. 3. Review the estimate below the slider. It shows roughly how many addresses your budget will cover based on your country mix. Address Validation recommends a budget based on your actual order volume from the last 30 days. For example, if you average 3 validations per order and had 92 orders last month, it'll suggest a cap that covers that volume. ![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_1350.png) Start with the recommended cap. If you reach your limit, verification pauses but checkout continues to work normally. You can increase the cap anytime to resume. # Step 3: Create your first verifier A verifier checks customer addresses against official postal databases to confirm they're deliverable. Results depend on the selected verifier and the address being checked. 1. Go to **Address Validation** and click **Create verifier**. 2. Enter a **Name** for internal reference (customers won't see this). 3. Set the status to **Active** when you're ready to go live, or leave it as **Draft** to configure first. ![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_2872.png) # Countries Select the countries you ship to. The verifier will only validate addresses for the countries you choose. Use the search field to find and add countries quickly. You can create separate verifiers for different country groups. For example, one verifier for the US and Canada with specific settings, and another for the rest of the world. # Provider settings Configure how the Experian verification engine behaves:

Setting	What it does	Recommended
Max API calls per checkout	Limits how many times an address is validated in a single checkout session. Prevents runaway costs when customers edit their address multiple times. Previously validated addresses use a cache, so re-entering the same address doesn't count.	5 (minimum 3)
Show ZIP+4 suggestions	For US addresses, suggests the full 9-digit ZIP code (e.g. 01702 becomes 01702-8003). Most stores don't need this.	Off
Show cosmetic formatting suggestions	Suggests formatting improvements like "Main St" to "Main Street." These are cosmetic only and don't affect deliverability.	Off
Require additional address fields	Only enable this if your store uses Shopify's additional address fields feature.	Off unless needed

# Step 4: Choose where verification runs Under **Advanced Settings**, open **Surface Settings** to control where your verifier is active.

Option	What it does	Plan required
Both checkout and post-purchase (recommended)	Validates at checkout and again on the Thank You Page and Order Status Page. Maximum coverage.	Shopify Plus
Checkout only	Validates before purchase only. No post-purchase suggestions.	Shopify Plus
Post-purchase only	Validates on the Thank You Page and Order Status Page after purchase.	All plans

![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_3400.png) # Allow accepting suggestions on the Thank You Page When this toggle is on, customers can accept address corrections directly on the Thank You Page with one click. When it's off, they'll need to go to the Order Status Page to edit their address. We recommend turning this on. It gives customers the fastest path to fixing their address right after checkout. # Step 5: Add verification conditions (optional) Conditions let you control when verification runs. This helps reduce costs by skipping verification for addresses that don't need it. Under **Advanced Settings**, open **Verification Conditions**. Choose one of two modes: **Skip verification** verifies all addresses except those matching your conditions. Use this to exclude trusted segments (e.g. repeat customers, domestic orders). **Run verification only** verifies only addresses that match your conditions. Use this to focus on high-risk orders (e.g. orders over a certain value, international shipments). Click **\+ Add Condition** to select from 16 available condition types including order total, shipping country, shipping method, and customer tags. For full details on each condition, see [Verification conditions and cost control](/docs/en/articles/14246815-verification-conditions-and-cost-control). ![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_5180.png) # Step 6: Configure the checkout block Some settings are configured in the Shopify checkout editor rather than in the Order Editing app. These settings control how the Address Validation block behaves in checkout. Your verifiers, validation rules, messages, conditions, and usage caps are still configured in Order Editing. 1. Go to **Shopify admin** > **Settings** > **Checkout**. 2. Click **Customise** next to your checkout configuration. 3. Find the **Address Validation** block in the sidebar.

Setting	What it does	Recommended
Allow app to block checkout	Enables the Error (Blocks Checkout) option for validation rules. When this is on, rules set to Error can prevent checkout until the customer fixes the issue. Verifiers still suggest corrections and do not block checkout on their own.	Off to start. Turn on only when you are ready to enforce blocking validation rules.
Include block in Shop Pay	Extends address validation to Shop Pay checkouts. It also helps the block appear in express checkout flows that support checkout extensions.	On
Automatically expand sections to show app	Auto-expands the validation section so customers can see validation results without clicking to expand the section manually.	On
Show confidence	Displays a confidence level on address corrections.	On if you want customers to understand how strong a suggestion is.
Enable logs	Turns on browser console logs for troubleshooting.	Off in production. Turn on only while testing with support.
Language	Previews a locale in the checkout editor.	Use this to review translated text. The live checkout language follows Shopify and the customer context.

⚠️ **Warning:** Only turn on **Allow app to block checkout** after testing your validation rules. Blocking rules can stop customers from completing checkout until the rule condition is resolved. The checkout editor settings do not choose which addresses are validated or when verifiers run. Those controls live in the Order Editing app under your verifier and validation rule settings. # Step 7: Set up validation rules (optional) Validation rules run instant, free format checks before the verifier runs. They catch common issues like missing house numbers, restricted regions, and special characters without costing you anything. 1. Go to **Address Validation** > **Validation Rules**. 2. Click **Create rule**. 3. Select one or more triggers (15 types available, including Missing House Number, Shipping Country, ZIP Code Range, Field Contains Text, and Field Matches Pattern). ![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_4844.png)![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_6135.png) 4. Choose a message type:

Type	Behaviour	Preview
Informational	Displays a message. Doesn't block checkout.	Example shown below
Warning	Displays a prominent message. Doesn't block checkout.	Example shown below
Error (Blocks Checkout)	Displays a message and prevents checkout until the customer fixes the issue. Requires "Allow app to block checkout" to be enabled in the checkout editor.	Example shown below

1. Write the message your customers will see. 2. Set the status to **Active** and click **Save**. For a full guide to triggers, logic, and examples, see [Validation rules](/docs/en/articles/14246758-validation-rules). Rules are free and run before verifiers. Adding rules for your most common address issues saves you money by catching problems before a paid verification runs. # Choose pages for each validation rule In the rule editor, use **Where this rule applies** to select **Checkout**, **Thank-you page** and/or **Order status page**. Keep at least one page selected. This is separate from the verifier's **Surface Settings**. Checkout blocking only applies to supported checkout rules with the required app-block permission. A message after purchase cannot prevent an already completed checkout. # Step 8: Add translations (optional) All customer-facing messages can be translated into any language your store supports. 1. Go to **Address Validation** settings. 2. Click **Translate** in the title bar. 3. Add translations for each language. Translatable strings include "Keep my address," "Use corrected address," "Validating address...," and all custom validation rule messages. Check the actual customer's Shopify language and the saved translation. The checkout editor's language selector is a preview control, not a store-wide language override. ![](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_3513.png) # Step 9: Save and publish 1. In the Order Editing app, make sure your verifier status is set to **Active**. 2. Click **Save**. 3. In the Shopify checkout editor, click **Save** to apply your block settings. Confirm the saved verifier and block settings, then check an actual checkout journey. Checkout validation can be tested before payment; a new order is only needed for the immediate Thank You flow. # Verify it's working After publishing, run a quick test to confirm everything is set up correctly. 1. Open your store in a new browser window (or use incognito mode). 2. Add a product to cart and proceed to checkout. 3. Enter a shipping address with a deliberate error (e.g. a misspelled street name or wrong ZIP code). 4. Confirm that a suggestion appears asking the customer to correct their address. 5. Accept the suggestion and verify the corrected address is applied. 6. Complete the order and check the Thank You Page for post-purchase validation (if enabled). If you enabled validation rules, test those too by entering an address that should trigger your rule (e.g. an address missing a house number). Turn on **Enable logs** in the checkout editor during testing. You can inspect the browser console to see validation requests and responses in real time. Turn it off when you're done. For a full testing walkthrough, see [Testing your Address Validation setup](/docs/en/articles/14246702-testing-address-validation-setup). # What customers see When a customer enters their shipping address, Address Validation responds with one of four results:

Result	What the customer sees
Verified	A green confirmation: "Your address has been validated and is correct."
Suggestion	A corrected address with two options: "Use corrected address" or "Keep my address." The customer always has the final say.
Clarification	A prompt asking the customer to check specific fields (e.g. street number, apartment). Multiple possible matches were found.
Not found	A message that the address couldn't be verified. The customer can review their details or keep their original address.

Customers can always override suggestions and proceed with their original address. Verification never blocks checkout unless you've configured a validation rule with the Error type. If the verification service times out or fails, checkout continues normally. # What's next Now that Address Validation is live, here are the next steps to get the most out of it: **Set up validation rules.** If you haven't already, create rules to catch common formatting issues before they hit the verifier. Rules are free and reduce your verification costs. See [Validation rules](/docs/en/articles/14246758-validation-rules). **Fine-tune your conditions.** Once you've been running for a few days, review your analytics and add conditions to skip verification for segments that rarely have bad addresses. See [Verification conditions and cost control](/docs/en/articles/14246815-verification-conditions-and-cost-control). **Review your analytics.** Check the Address Validation analytics dashboard to see how many addresses are being validated, how many suggestions customers accept, and your estimated cost savings. See [Address Validation Analytics](/docs/en/articles/14264633-address-validation-analytics). # Frequently Asked Questions ## Does validation slow down checkout? Validation runs within Shopify’s extension environment. Response times depend on the verifier and network. Check a representative checkout after changing your validation setup. ## Can validation block or fail checkout? Verifiers never block checkout. If the verification service times out or fails, checkout proceeds normally and the status is recorded for your review. Only validation rules set to the "Error" type can block checkout, and only if you've enabled the "Allow app to block checkout" permission in the checkout editor. ## Can customers keep their original address? Yes. Customers can always override suggestions and proceed with their original address. Address Validation is designed to suggest, not force. ## Does it work with Shop Pay and other express checkouts? Yes. Address Validation works with Shop Pay, Apple Pay, and other express checkout methods. Enable "Include block in Shop Pay" in the checkout editor to activate it. Validation displays in a mobile-optimised view on all devices. ## Can I create multiple verifiers? Yes. You can create separate verifiers for different country groups with different settings. For example, one verifier for US and Canada, and another for the rest of the world. ## Do I need validation rules if I have a verifier? Validation rules are optional but recommended. They catch formatting issues before the verifier runs, which saves you money (rules are free) and gives customers faster feedback. See [Validation rules](/docs/en/articles/14246758-validation-rules) to learn more. ## What happens when I reach my usage cap? Verification pauses automatically. Checkout continues to work normally without validation. Increase your cap anytime to resume. ## How do I disable Address Validation? Set your verifier status to **Draft** in the Order Editing app, or remove the Address Validation block from the Shopify checkout editor. No code changes needed. ## Can I see which addresses were corrected? Yes. The analytics dashboard shows total addresses corrected and validation success rates. Individual order details in your Shopify admin show whether each address was validated and corrected. See [Address Validation Analytics](/docs/en/articles/14264633-address-validation-analytics). ## How do I translate validation messages? Go to **Address Validation** settings and click **Translate** in the title bar. You can add translations for every customer-facing string, including "Keep my address," "Use corrected address," and all custom validation rule messages. # Validation message examples ![Example of an Address Validation message](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_2238.png)![Example of an Address Validation message](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_1458.png)![Example of an Address Validation message](https://staticfiles.gleap.io/helpcenter/6a2ba49a4a44749e9a2169f3/20260612063000_7224.png) ## Related - [What Is Address Validation](https://docs.orderediting.com/en/articles/14246443-what-is-address-validation.md) - [Testing Address Validation Setup](https://docs.orderediting.com/en/articles/14246702-testing-address-validation-setup.md)