Skip to main content

Location Restrictions on Shopify

How Ship Restrict for Shopify matches states, cities, and ZIP codes at checkout, block vs only-allow logic, and the block message buyers see

Last updated: 9/29/2026

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:

  1. States
  2. Cities (a city within a state)
  3. 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.

  1. Click Add city
  2. Choose the state
  3. Type the city name
  4. 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 as 83701
  • A buyer's ZIP+4 is shortened to five digits before comparing, so a 83701 rule blocks 83701-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

ShopifyWooCommerce
ZIP+4 addressesShortened to 5 digits before matchingMust match the entry exactly
ZIP code in a different state than the chosen stateChecked as enteredThe ZIP code's state is used
Entering ZIP codesCommas or new linesCommas
When the check runsDuring checkout; cart edits are never blockedOn 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:

  1. On the Shipping restrictions page, find Block message
  2. Type your message. Use {product} where the product's title should appear.
  3. 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