Skip to main content

Shopify Troubleshooting

Fix common Ship Restrict Shopify app problems: sync status warnings, checkout not blocking, rules that won't save, import errors, and paused enforcement

Last updated: 9/29/2026

Having issues with the Ship Restrict Shopify app? Start with the Sync status panel on the Shipping restrictions page, then find your symptom below.

On WooCommerce? See Troubleshooting.

Sync Status

Your rules are stored in the app and published to checkout. The Sync status panel shows whether checkout has your latest rules:

StatusMeaning
SyncedCheckout is enforcing your latest rules
Out of dateCheckout is enforcing an older copy of your rules
Not syncedNothing has been published to checkout yet

Click Re-sync to publish again. Opening the app also retries a failed sync automatically.

"Rule changes aren't live yet"

The last publish failed, and checkout is still using an older copy of your rules. The banner shows the reason after "last sync failed:". Click Re-sync now. If it keeps failing, the reason usually points to a limit:

  • "Rules are too large to enforce…": your rules together are over the size checkout can read. Combine hand-picked products into shared rules, or target tags, collections, or product types instead. See Size limits.
  • "…checkout supports at most 100. Consolidate rule targets.": your rules target more than 100 different collections or more than 100 different tags. Merge targets into fewer collections or tags.

"Rules have never been synced"

You have rules but none have been published yet. Click Sync now.

Checkout Enforcement Isn't Active

"Checkout enforcement isn't active"

This banner means the app couldn't register its checkout rule, and it includes the error. Your rules are saved and will enforce once the checkout rule is registered. Reload the app to retry, and contact support with the error if it persists.

The checkout rule was turned off

Ship Restrict enforces through a checkout rule named Ship Restrict location rules. In your Shopify admin, go to Settings → Checkout → Checkout rules and make sure it's turned on.

"Checkout enforcement is paused"

Your subscription isn't active, so rules are saved but not enforced. Enforcement resumes automatically when the subscription is active again. See Plan & Billing.

Rules Not Blocking

If Sync status shows Synced but a buyer isn't blocked, check in order:

  1. Is it a US address with a state? Addresses outside the US are never blocked.
  2. Does the rule cover the product?
    • Products in collections: the product must be in one of the selected collections
    • Products with tags: the product must have one of the selected tags, spelled the same way
    • Products of a type: the product's type must be one of the selected types
    • Specific products or variants: if you picked only some variants, other variants aren't covered
  3. Does the location match?
    • Cities must be spelled the way the buyer types them ("St. Louis" vs "Saint Louis") and paired with the right state
    • ZIP codes compare the first five digits
  4. Is the logic right? "Block shipping to these locations" blocks the listed places. "Only allow shipping to these locations" blocks everywhere else.
  5. Is the buyer still in the cart? Cart edits are never blocked. The check runs during checkout.

Too Many Things Blocked

  • An All products rule covers every product in the store
  • An only-allow rule blocks every US address outside its list, for everything it covers
  • Rules add up: one rule can't allow a location that another rule blocks. If two only-allow rules cover a product, the address has to be on both lists.

To stop a bad rule right away, delete it from the rules table. The change is published as soon as it's deleted.

Rules That Won't Save

The form shows "The rule couldn't be saved" with a list of problems:

MessageFix
Rule name is required.Enter a Name
A rule needs at least one location (state, city, or ZIP).Tick a state, add a city, or enter a ZIP code
State-city pair for "…" is missing a state.Choose a state for that city row, or remove the row
State-city pair for "…" is missing a city.Enter the city, or remove the row
A products rule needs at least one product.Click Select products, or choose another target
A collections rule needs at least one collection.Click Select collections, or choose another target
A tags rule needs at least one tag.Tick a tag, or choose another target
A product-types rule needs at least one product type.Tick a type, or choose another target

If the tag or type list is empty, no products in your store use tags or types yet. Add them to products first.

Import and Export Problems

Import errors appear under "The preset can't be imported":

  • "That file isn't valid JSON.": the file is damaged or isn't a JSON file
  • "That file isn't a Ship Restrict preset…": the file needs a preset section with a name and a rules list
  • A rule "is a WooCommerce category rule" or "tag rule": WooCommerce category and tag rules can't be imported. Remove them from the file and re-create them as collection- or tag-targeted rules. See moving rules between platforms.
  • "Select at least one rule to import.": tick at least one rule in the preview
  • "Rule 3 (…): …": that rule failed the same checks as the rule form, above

If the import succeeds but publishing fails, the banner says the rules were saved and asks you to use Re-sync on the rules page.

If Export rules shows "Export failed", reload the page and try again.

Getting Help

When you contact support, include:

  • Your store's myshopify.com address
  • The rule, product, and address you tested
  • What the Sync status panel says, and any banner text

Email support@shiprestrict.com or use the contact form.


Still need help? We're here to help you get your restrictions right.