Skip to content
Address Validation iO

Shopify app

Order checks, tags and corrections

Which orders Address Validation iO checks, the order tags, checking orders again, and how customers correct their address by email, on the order status page and in their account.

Address Validation iO checks the shipping address of every new Shopify order in the background, tags the order with the result and, when the address looks wrong, asks the customer to correct it. All of this works on every Shopify plan.

Which orders are checked

Situation What happens
AVIO is paused or the spending cap is reached No check and no tag. Logs show "Validation skipped" with the reason.
The sales channel isn't ticked under Settings → Orders (default: Online Store and draft orders) Skipped: the order gets the skipped tag and isn't billed.
No shipping address, nothing to ship, or local pickup or local delivery Skipped, as above.
Anything else Checked. The billing address too, if "Also validate billing addresses" is on (off by default).

The result is Valid, Needs checking, Invalid or Not checked; see How a check works. Then the follow-ups you use run: email and phone checks, a fulfillment hold, a correction request and a Shopify Flow trigger.

Under Settings → Orders you can also tick "Leave address line 2 out of provider checks".

The admin order block

The "Address validation" block on the order page in the Shopify admin shows the result, the email and phone check results and any hold. It offers Validate again and View history, which opens the order's history in Logs. Add it once from Home → Setup.

Checking an order again

  • Address changed in Shopify: AVIO checks the new address by itself, for orders it checked before. Not once the order is corrected or confirmed by the customer, and not while AVIO is paused or at its cap.
  • One order: Validate address in the order's More actions menu checks the order and offers Apply suggestion and Send correction email.
  • In bulk: select up to 250 orders in Shopify's order list and choose Validate addresses.
  • By filter: in AVIO under Logs → Orders, Re-check orders by filter finds the orders that match: created in the last 7 to 60 days, unfulfilled only, the current result and a shipping country. It shows how many match before you confirm. Up to 5,000 orders per re-check, newest first; cancelled orders are left out.
  • Shopify Flow: the action "Validate order address" (Flow package).

Re-checks aren't billed. A re-check never places a hold or sends a correction email by itself, but it releases a hold once the address is no longer Invalid.

In the order block, Validate again may reuse a stored provider answer younger than 24 hours. Ask the provider again always asks the provider.

Order tags

A tag is made of a prefix, a scope (shipping, billing, email, phone or checkout) and a word for the result. The defaults match the previous Address Validation iO app, so existing order filters and workflows keep working.

Default tag When
address-validation|shipping|success Valid, or the customer confirmed the address after the order
address-validation|shipping|error Needs checking or Invalid (one word for both by default)
address-validation|shipping|unsupported No provider for the country, or a "Skip validation" address rule matched
address-validation|shipping|skipped Not checked (see the table above), or no provider answered
address-validation|shipping|post-box A PO box a provider flagged, a blocked PO box or parcel locker, or a German Packstation (next to the result tag)
address-validation|shipping|manual Checked again by you, changed in Shopify or corrected by the customer
address-validation|shipping|confirmed The customer confirmed the address after the order (with success)
address-validation|checkout|confirmed The customer chose "Keep my address" in checkout
…|billing|…, …|email|…, …|phone|… Billing address (same words), and email and phone checks (valid, invalid, error)

Each address check replaces the earlier address tags. AVIO never removes your own tags.

Changing the tags

Under Settings → Orders, section "Order tags":

Setting Default Notes
"Tag orders" On Off: AVIO adds and removes nothing. Existing tags stay.
"Prefix" address-validation 1 to 40 characters
"Tag format" {prefix}|{scope}|{status} Must contain {scope} and {status}
"Words per result" As above An empty word means no tag for that result

Tags can't contain commas and must have 40 characters or less (Shopify's limit). "Reset to default (previous app's format)" brings the default tags back. A changed format reaches an order the next time it is checked.

Note: To tell Needs checking from Invalid in a tag filter, give them different words.

Correction requests

When an order's shipping address is Needs checking or Invalid, AVIO asks the customer to correct or confirm it:

  1. Thank-you and order status pages. The AVIO block shows a notice with the suggested address. The customer can choose Use this address, edit the address, or My address is correct. This needs the block placed on those pages (Home → Setup).
  2. Correction email. If nothing changes, the customer gets an email about 3 minutes after the order, with reminders.
  3. Customer account. Signed-in customers with new customer accounts can also fix it in their account (see below).

After the customer acts

The customer What happens
Confirms ("My address is correct") The order is "Confirmed by customer" and gets the success and confirmed tags. A hold is released and reminders stop.
Corrects it The new address is saved on the order and checked again ("Address corrected", tag manual). Reminders stop.
Does nothing No more emails after the last reminder.

Correction emails

The email shows the address as entered, what is wrong when AVIO knows (for example "Please add the house number."), the first suggestion and a Check or correct address button. It goes out only for Needs checking and Invalid addresses. Reminders stop once the customer corrects or confirms the address, the address is Valid, the order is locked or emails are switched off.

Under Settings → Customer emails:

Setting Default
"Ask customers to correct invalid addresses by email" On (covers Needs checking too)
"Send reminders" 2 and 24 hours after the first email; at most 5 reminders, 1 to 720 hours
"Send me a copy of each correction email" Off
"Reply-to address" Empty: replies go to your verified sender address, else to your store email
"Correction link" Classic customer accounts: the correction page; all others: the order status page

New reminder times apply to new orders. To send one email by hand, use Send correction email in the order's Validate address action. It sends one email without reminders.

Where the button leads

  • "Order status page (Address Validation iO block)": Shopify's order status page with the AVIO block. Needs new customer accounts and the block placed there.
  • "Address Validation iO correction page": a page on your own domain, inside your theme. Needs an Online Store. It offers "Use this address", an edit form (the country can't be changed) and "My address is correct".

When in doubt, choose the correction page: it works whether or not the block is placed.

Note: The correction page uses Shopify's app proxy path /a/address-validation. If you changed it in Shopify (Settings → Apps → Address Validation iO → App proxy), enter the new path under "Changed app proxy path", or the link breaks.

Look, texts and sender

Set the sender name, logo, accent color and footer under Design & language → Email, and the texts under Design & language → Edit texts. Emails come in English, German, French, Spanish, Italian and Dutch, in the customer's order language.

Correction emails come from AVIO's address by default. To send them from your own address, open Settings → Email sender, enter an address on a domain you own and add the DNS records the page shows. Once they are verified, usually within minutes and at most within 72 hours, emails come from your address.

The address change lock

Under Settings → Orders → "Address changes by customers" you decide until when customers may change the address:

  • "Lock once the order is": Pending fulfillment, In progress (default), Partially fulfilled or Fulfilled. A shipped order is always locked.
  • "Also lock after": a number of hours or days after the order, at most 60 days. Empty means no time limit.

A locked order gets no more emails, and the correction page tells the customer to contact the shop.

Customer accounts

In stores with Shopify's new customer accounts, AVIO shows signed-in customers which open orders need an address check, and flags saved addresses that look wrong. It works on every Shopify plan.

Where in the account What the customer sees
Order list A banner such as "1 order needs your attention" with a "Check addresses" button
Address check page Each flagged order with its correction notice
An order's page The correction notice for that order (the order status block)
Profile, below the addresses "Please check this saved address", with "Use suggested address" and "Address is correct"

To set it up:

  1. Keep "Ask logged-in customers to check their addresses in their account" on under Settings → Customer accounts & headless (on by default).
  2. Under Settings → Checkout → "Where Address Validation iO runs", use Add in accounts editor for the Orders block, the Profile block and the Address check page.
  3. In the accounts editor, add the page with "Add page to Accounts". Without it, the banner's button leads nowhere.

An order shows up when it is open, not cancelled, not fully shipped, at most 60 days old, Needs checking or Invalid, not yet confirmed or corrected, and not locked. Classic customer accounts don't get these blocks; their customers use the email link. Headless stores use the headless widget.

Troubleshooting

An order has no AVIO tag. If AVIO was paused or at its cap, Logs show "Validation skipped" with the reason. If the check ran, "Tag orders" may be off or that result's word empty.

The customer didn't get a correction email. Emails go out only for Needs checking and Invalid addresses, while emails are on and the app is active. They are skipped when the customer already fixed the address or the email check found no mailbox. Logs show what happened.

The customer doesn't see the correction notice. It needs the AVIO block on the thank-you or order status page, and an order the customer may still change. With classic customer accounts, set the correction link to "Address Validation iO correction page".