Address Validation lets you define rules that check the customer’s shipping address before an order is placed. If the address matches your rule’s conditions, checkout is blocked and the customer sees your custom error message.
- Go to Address Validations and click Create validation.
- Configure settings (see below).
- Toggle the rule active.
- Click Save.
| Setting | Description |
|---|
| Status | Active or Inactive |
| Conditions | The rules that decide when checkout should be blocked |
| Condition logic | Block when any condition matches or all conditions match |
| Error message | Message shown to the customer when checkout is blocked |
- The listing shows all rules with their active/inactive status.
- Toggle rules on/off without deleting them.
- Delete a rule to remove it permanently.
- New rules start as Inactive. You must explicitly activate them.
- Works on checkout page only.
| Scenario | Conditions to set |
|---|
| Block PO Box deliveries | Address line 1 contains PO Box OR P.O. Box (use “Any” logic) |
| Restrict to specific countries only | Country is not your list of served countries |
| Block specific zip code ranges | Zip starts with restricted prefix |
| Block deliveries to a specific city or region | City contains restricted area name |
- Write error messages that tell customers what to do next: “We don’t ship to PO Boxes. Please enter a home or business address.”
- Test both a matching address (should block) and a valid address (should pass) before going live.
| Address Validation | Order Validation |
|---|
| Blocks based on where the order ships: address fields (city, zip, country, address lines, first/last name) | Blocks based on what is in the cart or who the customer is: cart total, product tags, customer tags |
| Use for shipping restrictions (regions, PO boxes, unsupported countries) | Use for cart-level rules (minimum order, restricted product combos, fraud signals) |
