Shipping regions are advanced features available on the Scale plan.
ArrivesBy can show different delivery estimates based on where your customer is located. This lets you set accurate transit times for customers in different parts of the world. Geolocation is currently supported for visitors in the United States, Canada, Australia, and New Zealand.
How location is detected
ArrivesBy determines a customer's location using three signals, in order:
Logged-in account address — if the customer is logged into your store, ArrivesBy uses the state or province from their default delivery address.
Zip or postal code — the customer can enter their zip or postal code directly into the widget to get an updated estimate.
IP address — if neither of the above is available, ArrivesBy falls back to their IP address for geolocation.
Shipping regions
Shipping regions let you group states and provinces into named delivery zones — for example, "East coast," "West coast," and "Midwest." Once a region is set up, you can scope a rule to it so customers in those states or provinces see transit times that reflect their actual distance from your warehouse.
If a customer's location isn't in any region, ArrivesBy falls back to your rules without a region filter — typically your Default rule or a broader product rule.
One region per state or province
Each state or province can only belong to one region. If you try to add one that's already used in another region, ArrivesBy will flag the conflict.
Creating a region
Go to Regions in the ArrivesBy app and click Add region.
Name — give the region a descriptive name (e.g., "East coast" or "Pacific Northwest"). This name appears in the Shipping region filter when editing a rule.
States/provinces — select the states or provinces to include in this region. You can add as many as you like, as long as each isn't already used in another region.
Save the region, then repeat for each delivery zone you want to define.
Using regions in rules
Once you've created your regions, you can apply them using the Shipping region filter in the Additional filters section of a rule.
Example setup:
Default rule — 5–8 day transit (catch-all for customers outside any region)
East coast rule — Shipping region: East coast → 2–3 day transit
West coast rule — Shipping region: West coast → 4–6 day transit
A customer in New York sees 2–3 days. A customer in California sees 4–6 days. A customer in a state not assigned to any region sees 5–8 days from the Default rule.
You can also combine a region filter with product scope — for example, a rule for Furniture products and the East coast region. See How rules work for the full guide on rule setup and priority.
Deleting a region
Deleting a region also deletes any rules that were scoped to it. Make sure to review your rules before removing a region to avoid accidentally removing active delivery configurations.