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
- Create a rule: Block, All products, state Idaho (ID)
- On your storefront, add any product and go to checkout
- Enter an Idaho address, for example 123 Main St, Boise, ID 83702
- Expected: checkout shows your block message with the product's title and won't complete
- Change the address to another state, for example Arizona
- Expected: the message goes away and checkout can complete
Test 2: City Rule
- Add a city row for Boise, ID to a block rule
- Check out to a Boise address, then to "BOISE"
- Expected: both blocked, because city matching ignores case
- Check out to another Idaho city with the state not otherwise blocked
- Expected: not blocked
Test 3: ZIP Code Rule
- Add
83702to a block rule - Check out to an address with ZIP 83702, then with 83702-1234
- Expected: both blocked, because ZIP+4 is shortened to five digits
- Check out with a different ZIP in the same state
- Expected: not blocked, unless the state or city is also listed
Test 4: Only-Allow Rule
- Create a rule: Only allow, All products, state Texas (TX)
- Check out to a Texas address
- Expected: not blocked
- Check out to any other US state
- Expected: blocked
- Check out to a non-US address
- Expected: not blocked, because only US addresses are checked
Test 5: Targeted Rules
For each target you use:
- 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
- Expected: blocked
- Swap it for a product the rule doesn't cover
- Expected: not blocked
For variant rules, test both the restricted variant and a sibling variant.
Test 6: Mixed Cart
- Add one restricted and one unrestricted product
- Check out to a restricted address
- Expected: one error naming only the restricted product
- Go back to the cart and remove the restricted product
- Expected: removing works normally, and checkout then completes
Cart edits are never blocked. The check runs during checkout.
Test 7: Block Message
- Under Block message, enter a message using
{product}and click Save message - Repeat Test 1
- 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.