Shopify-App
Install and set up
Install the Shopify app, approve the plan, work through the Setup checklist on Home and test an address.
This guide takes you from installing Address Validation iO in your Shopify store to checking your first orders. Most of it is the "Setup" checklist on the app's Home page.
Install the app
- Open the app listing in the Shopify App Store and click install.
- Approve the permissions Shopify shows.
- When you open the app, approve the subscription in Shopify. New installs start on Pay as you go (the Free plan on the pricing page) with 500 free checks, once per store.
A new install checks nothing until you click Activate validation on Home. That gives you time to review the settings first.
Work through the Setup checklist
Home → Setup lists the steps for your Shopify plan, each with a link to the right place. AVIO can't detect blocks you place in Shopify's editors, so mark those steps done with Mark as done.
1. Activate validation
Click Activate validation. From now on AVIO checks new orders. You can stop checks at any time with Pause validation on Home: nothing is checked and no usage is billed while paused, but package fees keep running.
2. Review your providers
Open Providers. The table "Address validation provider per shipping country" shows the provider, backup provider and mode for each country, plus an "All other countries" row for every country without its own row. Rows marked Recommended follow AVIO's recommended setup and its updates. Most shops keep it. If you change a row, it becomes Custom; Use recommended brings one row back, Reset to recommended resets all rows. What the modes do: How a check works.
3. Place the AVIO blocks
| Block | Where | Shopify plan |
|---|---|---|
| "Address Validation iO address check" | Checkout editor, right before the shipping methods or as a block anywhere in checkout | Shopify Plus |
| "Address Validation iO email check" | Checkout editor, contact section | Shopify Plus |
| Address Validation iO block on the thank-you page | Checkout editor, thank-you page | All plans |
| Address Validation iO block on the order status page | Checkout editor, order status page | All plans |
| "Address validation" admin block | Any order page in the Shopify admin, under Blocks | All plans |
For the admin block, open any order, click + Block under Blocks, choose Address validation and pin it so it shows on every order for all staff.
The thank-you and order status blocks show customers a correction notice when their address needs checking. Details on the checkout blocks: Checkout.
4. Activate the checkout rules
Click Activate checkout rules. These simple format rules run in checkout on every Shopify plan, without a provider: house number, postal code format, PO boxes, Packstation and others. When a rule fails, the customer sees an error at the field and can't pay until it is fixed. Configure them under Settings → Checkout. See Checkout.
5. Turn off Shopify's own address validation (Shopify Plus)
Once the "Address Validation iO address check" block is in your checkout, turn off Shopify's "Validate shipping address" (Shopify admin → Settings → Checkout → Address collection). Both suggest corrections, and Shopify advises using one or the other. On other plans you can leave Shopify's setting as it is.
Choose where the correction email leads
Customers whose address needs checking get a correction email. Under Settings → Customer emails → Correction link, choose where its button leads:
- "Order status page (Address Validation iO block)" fits new customer accounts, with the order status block placed.
- "Address Validation iO correction page" is a page on your own domain, inside your theme. It works whether or not the block is placed, and is the right choice for classic customer accounts.
See Order checks.
Test an address
On the Providers page, Test an address runs a real check with your current settings, providers and address rules and shows the result. It isn't an order and isn't billed. Use it before you change a mode or a rule.
Find your way around
| Menu item | What you do there |
|---|---|
| Home | Setup checklist, status, pause and activate |
| Analytics | Checks, corrections and estimated savings. See Analytics |
| Cost calculator | The cost per failed delivery behind the savings estimate |
| Logs | Every check, email, correction and settings change, and the Orders list |
| Providers | Providers and modes per country, email and phone providers, A/B tests |
| Design & language | The look and texts of the checkout notice, the order status block and the emails, and the languages customers see |
| Settings | Checkout, orders, emails, holds, address rules, delivery points, customer contact, plan and more |
| Support | Frequently asked questions and contact |
Themes and languages
AVIO uses Shopify's checkout and customer account extensions, not theme code, so it works with every theme. Its blocks take fonts and colors from your checkout branding. The correction page is the exception: it uses your online store theme.
Customers see AVIO's texts in English, German, French, Spanish, Italian or Dutch, in the language they shop in if you have it switched on. Change the texts and switch languages on or off under Design & language → Edit texts.
Missing permissions
If AVIO needs a permission you haven't granted yet, for example to place fulfillment holds, the app shows the banner "Address Validation iO needs a few more permissions". Click Review permissions and approve in Shopify.
Uninstalling
Checks, emails and reminders stop at once. About 48 hours later your store's data is erased. Release any orders AVIO put on hold before you uninstall: afterwards AVIO can't release them.