Learn how Ship Restrict for Shopify decides whether a shipping address matches a rule, and how to control the message buyers see at checkout.
On WooCommerce, matching works slightly differently. See Location Restrictions on WooCommerce.
Which Addresses Are Checked
Ship Restrict checks each delivery address at checkout. Only United States addresses with a state are checked; addresses in other countries are never blocked.
If a checkout splits items across several deliveries, each item is checked against the address of its own delivery.
Every rule can list three kinds of location, under Locations in the rule form. An address matches the rule if it matches any of them:
- States
- Cities (a city within a state)
- ZIP codes
A rule needs at least one location. Otherwise it won't save: "A rule needs at least one location (state, city, or ZIP)."
States
The States section lists every state as a checkbox, shown as name and code, for example "Idaho (ID)".
- Type in Filter states… to narrow the list by name or code. Ticked states stay ticked while you filter.
- The badge shows how many are selected. Clear unticks them all.
The list includes the 50 states, Washington DC, US territories such as Puerto Rico, and the armed forces codes. A state matches when the checkout address is in that state.
Cities
Cities are always paired with a state, so Springfield in Illinois and Springfield in Missouri are different entries.
- Click Add city
- Choose the state
- Type the city name
- Use the delete icon to remove a row
Matching rules:
- The city must be in the paired state
- Case doesn't matter: "boise" matches "Boise"
- Spelling does matter: "St. Louis" doesn't match "Saint Louis". Add both spellings if your buyers use both.
A row with only a state or only a city stops the rule from saving, and the form tells you which row is incomplete. Completely empty rows are ignored.
ZIP Codes
Enter ZIP codes in the ZIP codes box, separated by commas or new lines, for example 83701, 10001.
ZIP codes are compared as five digits:
- A ZIP+4 you enter, like
83701-1234, is saved as83701 - A buyer's ZIP+4 is shortened to five digits before comparing, so a
83701rule blocks83701-1234
Note: This differs from WooCommerce, where a ZIP+4 address doesn't match a five-digit entry.
Block vs Only Allow
Choose the Logic for each rule:
Block Shipping to These Locations (Default)
Checkout stops for buyers in any listed location. Use it when you ship nationwide with a few exceptions.
Only Allow Shipping to These Locations
Checkout stops for buyers anywhere in the US that isn't listed. An address is allowed if it's in any of the listed states, cities, or ZIP codes. Use it for delivery areas, dealer territories, or a short list of states where you're licensed.
Important: If several only-allow rules cover the same product, the address must be on every one of their lists. Put all allowed places for a product in one rule.
Combining Location Types
A single rule can list states, cities, and ZIP codes together:
Local delivery zone
- Logic: only allow
- ZIP codes: the ZIPs you deliver to
Block a state plus a few cities elsewhere
- Logic: block
- States: the restricted state
- Cities: each restricted city with its state
Ship a product line to one state, except one city
- Rule 1: only allow, State: TX
- Rule 2: block, City: Austin, TX
Differences From WooCommerce
| Shopify | WooCommerce | |
|---|---|---|
| ZIP+4 addresses | Shortened to 5 digits before matching | Must match the entry exactly |
| ZIP code in a different state than the chosen state | Checked as entered | The ZIP code's state is used |
| Entering ZIP codes | Commas or new lines | Commas |
| When the check runs | During checkout; cart edits are never blocked | On the cart and checkout pages |
The Block Message
When items can't ship, checkout shows one error per restricted product. The default message is:
{product} cannot currently be shipped to your location. Please remove from cart to continue.
To change it:
- On the Shipping restrictions page, find Block message
- Type your message. Use
{product}where the product's title should appear. - Click Save message
Clear the box and save to go back to the default.
If your message includes {product}, buyers see one error per restricted product, with each product's title filled in. Without {product}, they see your message once.
The same message is used for every rule. It doesn't name the state, city, or rule that caused the block.
Questions? Our support team can help you set up location restrictions. Contact us at support@shiprestrict.com