Skip to main content

Shopify Testing Guide

Test your Ship Restrict rules on a real Shopify checkout: states, cities, ZIP codes, only-allow rules, targeted rules, and the block message

Last updated: 9/29/2026

Testing confirms your rules block what they should and nothing else. This guide gives you a repeatable test plan for the Ship Restrict Shopify app.

Testing a WooCommerce store? See the WooCommerce Testing Guide.

Before You Start

  • Check Sync status. On the Shipping restrictions page, the Sync status panel should show Synced: "Checkout is enforcing your latest rules." If not, click Re-sync.
  • Test on a development store if you have one. Export your rules from Import & export and import them there. Development stores aren't charged for the plan.
  • Use a private browser window so an old cart or saved address isn't reused.

You don't need to place real orders. The block appears at checkout as soon as a restricted item and a restricted US address are both present, and the order can't be completed.

Test 1: State Rule

  1. Create a rule: Block, All products, state Idaho (ID)
  2. On your storefront, add any product and go to checkout
  3. Enter an Idaho address, for example 123 Main St, Boise, ID 83702
  4. Expected: checkout shows your block message with the product's title and won't complete
  5. Change the address to another state, for example Arizona
  6. Expected: the message goes away and checkout can complete

Test 2: City Rule

  1. Add a city row for Boise, ID to a block rule
  2. Check out to a Boise address, then to "BOISE"
  3. Expected: both blocked, because city matching ignores case
  4. Check out to another Idaho city with the state not otherwise blocked
  5. Expected: not blocked

Test 3: ZIP Code Rule

  1. Add 83702 to a block rule
  2. Check out to an address with ZIP 83702, then with 83702-1234
  3. Expected: both blocked, because ZIP+4 is shortened to five digits
  4. Check out with a different ZIP in the same state
  5. Expected: not blocked, unless the state or city is also listed

Test 4: Only-Allow Rule

  1. Create a rule: Only allow, All products, state Texas (TX)
  2. Check out to a Texas address
  3. Expected: not blocked
  4. Check out to any other US state
  5. Expected: blocked
  6. Check out to a non-US address
  7. Expected: not blocked, because only US addresses are checked

Test 5: Targeted Rules

For each target you use:

  1. Add a product the rule covers (in the collection, with the tag, of the type, or the picked product or variant) and check out to a restricted address
  2. Expected: blocked
  3. Swap it for a product the rule doesn't cover
  4. Expected: not blocked

For variant rules, test both the restricted variant and a sibling variant.

Test 6: Mixed Cart

  1. Add one restricted and one unrestricted product
  2. Check out to a restricted address
  3. Expected: one error naming only the restricted product
  4. Go back to the cart and remove the restricted product
  5. Expected: removing works normally, and checkout then completes

Cart edits are never blocked. The check runs during checkout.

Test 7: Block Message

  1. Under Block message, enter a message using {product} and click Save message
  2. Repeat Test 1
  3. Expected: your message, with the product's title in place of {product}

Test Plan Template

Rule: ________________________________
Product tested: ______________________
Address used: ________________________
Expected: Blocked / Not blocked
Actual:   Blocked / Not blocked
Sync status: Synced / Out of date
Date / tester: _______________________

When to Re-Test

  • After adding, editing, deleting, or importing rules
  • After changing which products are in a targeted collection, or their tags or types
  • After your subscription is renewed following a lapse
  • When regulations change and you update your rules

When Tests Fail

  • Not blocked when it should be: check Sync status, then the rule's target and locations. See Shopify Troubleshooting.
  • Blocked when it shouldn't be: look for an only-allow rule covering the product
  • Checkout never blocks anything: check the checkout rule is on. See Shopify Troubleshooting.

Stuck on a test? Email support@shiprestrict.com with the rule, the product, and the address you used.