Help and setup guide
Every Parcel Rules feature is powered by Shopify Functions, so it runs natively at Shopify checkout on any plan. Set up only the ones you need. Each section below covers what the feature does, how to set it up, a reference table of every setting, and what to check if something is not working.
1. Free shipping by collection
Offer free shipping (or a set discount percentage) once a customer spends enough on a chosen collection, counted separately from the rest of the cart.
Before you start, set up separate shipping profiles. This feature works by making one delivery rate free, so the products it applies to need their own shipping profile with its own delivery rate. Create that in Settings, Shipping and delivery first. Keeping those products in a separate profile is what lets free shipping apply to them only, while the rest of the cart keeps its normal rates.
Set it up
- In Parcel Rules, click Set up free shipping threshold (or go to Shopify admin, Discounts, Create discount, and choose the Parcel Rules free-shipping discount).
- On the discount page, set the qualifying threshold, the eligible collection(s) or products, the delivery rate to discount, and the discount percentage (default 100, which means free).
- Save the discount and make sure its status is Active.
Settings reference
| Setting | What it does | Default |
|---|---|---|
| Included collections / products | The products whose spend counts toward the threshold. Choose collections, specific products, or both. | Every product counts |
| Excluded collections / products | Products that never count, even if they sit in an included collection (for example, gift cards). | Nothing excluded |
| Delivery rate(s) to make free | The checkout shipping rate(s) the discount applies to, matched by name. Pick from your active rates or type a name. | The rate the customer selects |
| Minimum spend to unlock free shipping | The spend on counting products needed before the discount applies, per rule. | Required |
| Maximum spend (optional) | An upper limit for the rule. Once the counted spend reaches this amount the rule stops applying, so a higher-threshold rule can take over. For example, free Regular up to 250 and free Express from 250, so the cheaper free rate is the default below 250 and Express becomes free (and the default) above it. Leave blank for no limit. | No upper limit |
| Shipping discount (%) | How much to take off the rate. 100 makes it free; lower it for a partial discount (for example, 50 for half-price shipping). | 100 |
| Countries this rule applies to | Limit the rule to shipping addresses in these countries. | Any country |
| States/provinces this rule applies to | Narrow the rule further within the selected countries, where state/province data is available. | All in those countries |
| Discount label shown at checkout | The text shown next to the discounted rate at checkout. | Free shipping |
You can add several rules. The first rule whose region matches the shipping address sets the threshold.
How it works
A Shopify Function adds up the value of the eligible collection's lines and discounts the chosen delivery rate once that subtotal reaches your threshold. Because it runs inside Shopify's checkout, it works on Basic, Shopify, Advanced, and Plus, not just Plus.
Test it on your storefront
- Add products from the eligible collection until the cart reaches your threshold, plus a product from a different shipping profile (like a bulky item).
- Go to checkout and enter a shipping address. The eligible products' delivery rate should be free (or discounted by your percentage), while the other product's rate is unchanged.
- Remove eligible items to drop below the threshold, and the rate returns to its normal price.

Good to know: the function matches the delivery option by its name, so use a flat delivery rate whose name matches the rate you configured. Products outside the eligible collection do not count toward the threshold.
If free shipping isn’t applying with a discount code
Shopify only stacks a free shipping discount with another discount when both allow it. If a shopper uses a code that doesn’t allow shipping discounts, Shopify drops the free shipping and charges the delivery rate. Codes made by marketing, email and social tools often have this turned off. The giveaway is an order that qualified for free shipping but shows a delivery charge, with a discount code applied.
Parcel Rules checks for this for you. When an active discount blocks free shipping, the app dashboard shows a warning that names the discounts. You can dismiss it, and it returns if a new blocking discount appears.
Fix one discount
- In Shopify, go to Discounts and open the discount code.
- Under Combinations, tick Shipping discounts and save.
- Open your Parcel Rules free shipping discount. Under Combinations, tick both Product discounts and Order discounts, then save. Both sides must allow it.
Fix many discounts at once
Shopify has no bulk editor for this, but a bulk-edit app such as Matrixify can do it:
- Export your active discounts, and keep the file as a backup.
- In the sheet, find the rows where Combines With: Shipping Discounts is FALSE. Skip free shipping discounts, which can’t combine with shipping.
- Set those cells to TRUE and leave every other column as it is.
- Delete the rows you didn’t change, then import the file with the existing items set to update, not replace.
- Re-export, or open a couple of discounts, to check the box is ticked. Some discounts created by other apps can only be edited in that app, so check the import results for any that failed.
Stop it happening to new codes (optional)
Shopify Flow, a free Shopify app, can tick the box on every new code automatically:
- Open the Flow app and choose Create workflow.
- Select the trigger Discount code created.
- Add the action Send Admin API request and choose the
discountCodeBasicUpdatemutation. - In Mutation inputs, replace everything with the JSON below. Keep only these fields, so the code’s other settings aren’t overwritten.
- Name the workflow, for example “Allow shipping discounts”, and turn it on.
{
"id": "{{discount.id}}",
"basicCodeDiscount": {
"combinesWith": { "shippingDiscounts": true }
}
}Good to know: this ticks Shipping discounts on every new standard amount-off code, including any you meant to keep separate. It doesn’t cover buy X get Y codes or automatic discounts, and it doesn’t change existing codes. Create a test code afterwards and check the box is ticked.
Shopify is making this native
Shopify is rolling out market-driven shipping, which can set collection-based shipping thresholds natively, counting a collection’s subtotal on its own. If your store is on market-driven shipping, you may not need this rule for a straightforward “free shipping over $X on collection A” offer. We’d rather tell you that than have you pay for something Shopify now does for you. When it’s available on your store, Parcel Rules flags it on the home page.
Set it up natively
- In Settings → Shipping and delivery (or your Markets shipping settings), add or edit a shipping rate for the zone/market you want.
- Limit the rate to specific collections, then add a price condition so the rate is free once that collection’s subtotal reaches your threshold.
- Repeat for each collection that needs its own threshold. Two collections in one cart can each carry their own threshold, counted separately.
For the exact steps on your store, see Shopify’s own shipping rates guide.
When this rule still helps
- You’re on any plan and haven’t moved to market-driven shipping yet (it’s a gradual rollout).
- You want to exclude products from the count (for example, count a collection but ignore gift cards), scope by specific products, or apply a partial discount rather than fully free.
- You’re pairing it with the other Parcel Rules features (free gift, delivery zones, field rules, delivery rate rules), which market-driven shipping doesn’t do.
2. Delivery zones by postcode
Restrict flagged products to the postcodes you actually deliver to. Shoppers outside the zone are blocked at checkout with a clear message you write.
Set it up
- In Parcel Rules, click Set up delivery zones (or go to Shopify admin, Settings, Checkout, and add the Parcel Rules checkout rule).
- Configure the flagged products (collections or specific products), the allowed postcodes, the country, and the customer message shown when a delivery is blocked.
- Save the rule.
Settings reference
| Setting | What it does | Default |
|---|---|---|
| Restricted collections / products | Which products are delivery-restricted. A product is restricted if it is in a chosen collection or is a chosen product. | At least one required |
| Checkout error message | A blocking error shown at the top of checkout when an order can't be delivered. Use {zip} for the shopper's postcode (or country code when no zone covers the country) and {product} for the restricted product name(s). | Inline message only |
| Check Pickup Point orders | Whether orders going to a carrier Pickup Point (such as a parcel locker) are checked the same way as shipping orders. Turn it off to allow any Pickup Point. In-store pickup and in-person sales are never checked. | On |
| Countries this zone applies to | Limit the zone to these shipping countries. | Any country |
| Deliverable postcodes | The postcodes this zone can ship to. Separate them with commas, spaces, or new lines. Use * to match any run of characters (2* covers 2000-2999) and ? for a single character (200? covers 2000-2009). Matching ignores case and spaces. For UK addresses you can list outward codes (E1, SW1A) to match a whole district exactly. | Required |
| Validation message | The inline message beneath the postcode field when this zone blocks the order, or beneath the country field when no zone covers the country (then {zip} is the country code). Supports {zip} and {product}. | Optional |
| Show the message before payment | Show the message as soon as the customer enters an address (country and postcode) outside the zone, even before a delivery method is chosen. Countries without postcodes are checked when the customer pays. For a country no zone covers, every zone needs this on. When off, it waits until a delivery method is chosen or the customer presses Pay, so a customer choosing in-store pickup isn't warned about a saved address. Express checkouts (Shop Pay, Apple Pay, Google Pay, PayPal) are still checked when the customer pays. | On for new zones |
You can add several zones. An order is allowed if its address matches any zone that covers a restricted product.
How it works
A Cart and Checkout Validation function checks the delivery address at checkout. If a flagged product cannot be delivered to that postcode, checkout is blocked with your message. Addresses inside the zone proceed normally. With Show the message before payment on, the customer sees the message as soon as they enter a country and postcode outside the zone, before choosing a rate or paying. The cart page never shows it.
Test it on your storefront
- Add a flagged product to the cart and go to checkout.
- Enter a delivery address with a postcode outside your allowed list. Checkout is blocked and your message is shown.
- Change to an in-zone postcode, and checkout proceeds normally.
- A cart with no flagged products is never blocked, whatever the postcode.
- Choose in-store pickup instead of shipping, and checkout proceeds normally.

Good to know: the block only applies when a flagged product is in the cart and is being delivered. In-store pickup and in-person sales are never blocked. Matching ignores case and spaces, and you can use wildcards (2*) or, for the UK, outward codes (SW1A) to cover a whole range at once.
3. Free gift with purchase
Automatically add a chosen product to the cart once it qualifies, and make it free at checkout. It is removed automatically if the cart drops below the threshold, and it is never charged.
Set it up
- In Parcel Rules, click Set up free gift (or go to Shopify admin, Discounts, Create discount, and choose the Parcel Rules free-gift discount).
- Configure the gift product or variant, the qualifying threshold, the eligible collections or products, an optional country, and the cart message. Save, and make sure the discount is Active.
- Turn on the storefront widget: in the free-gift card click Open theme editor, enable the Gift with purchase app embed, and Save the theme.
Settings reference: the discount
Set these on the free-gift discount in Shopify admin, Discounts.
| Setting | What it does | Default |
|---|---|---|
| Gift product & variant | The product, and specific variant, given for free. Keep it in stock, as its inventory is still tracked. | Required |
| Minimum spend to unlock the gift | The spend on counting products needed before the gift is added. | 0 (any purchase) |
| Products that count toward the spend | Limit which products count, by collection, specific product, or specific variant. | Every product counts |
| Countries this offer applies to | Limit the offer to these shipping countries. | Any country |
| Message shown on the free gift line | The text shown next to the gift line in the cart and at checkout. | Free gift added |
How it works
The theme app embed watches the cart and adds or removes the gift as the cart qualifies. A discount function makes the gift line free and is the authority on pricing at checkout, so the gift is always free when it is present. This feature needs an Online Store 2.0 theme.
Test it on your storefront
- Add eligible products until the cart reaches the threshold. The gift is added automatically and shows at $0.
- Go to checkout and confirm the gift line is free and not in the order total.
- Remove items to drop below the threshold, and the gift is removed automatically.

Settings reference: the app embed
Set these in the theme editor, under the Gift with purchase app embed. The confirmation is optional: off by default, the gift is added silently. Turn it on to give shoppers clear feedback, even on themes whose cart drawer does not pop open. It shows the gift's image and name alongside your message, echoes the cart's free-gift cues (usual price struck through, plus a tag), and inherits your theme's font.
| Setting | What it does | Default |
|---|---|---|
| Don't re-add the gift if the shopper removes it | If a shopper removes the gift, it stays gone for the rest of their session instead of being added back. | On |
| Show a confirmation when the gift is added | Shows a popup confirming the gift was added. The settings below apply only when this is on. | Off |
| Display style | Toast (a small popup near a screen edge) or Modal (a centred card over a dimmed background). | Toast |
| Heading | The confirmation's main line. | Free gift added! |
| Subtext | An optional second line under the heading. | Blank |
| Show the gift's image | Show the gift's image in the confirmation. | On |
| Show the gift's name | Show the gift's name in the confirmation. | On |
| Show the value | Show the gift's usual price struck through next to a “Free” label. | On |
| “Free” label | The wording next to the struck-through price. Leave blank to hide it. | Free |
| Tag label | The small tag chip, like the cart's discount tag. Leave blank to hide it. | Free gift |
| Toast position | Where the toast appears: top or bottom, and left, centre, or right. Toast style only; the modal is always centred. | Bottom right |
| Animation | How the confirmation appears: slide in or fade in. Reduced motion is respected automatically. | Slide in |
| Auto-dismiss after | How long the confirmation stays on screen (2 to 15 seconds). Shoppers can also close it; the modal also closes on background click or Escape. | 5s |
| Background colour | The confirmation's background colour. | #ffffff |
| Text colour | The confirmation's text colour. | #1a1a1a |
If the gift is not appearing
- Check the free-gift discount exists and is set to Active.
- Check the Gift with purchase app embed is enabled and the theme is saved.
- Check the cart actually qualifies: the threshold is met by eligible products, and the buyer's country matches any country setting.
- If your theme's cart doesn't update to show the gift straight away, don't worry: the gift is still added and is free at checkout.
- The widget runs on Online Store 2.0 themes only. It does not run in POS, headless storefronts, or during checkout edits, but the discount function still keeps the gift free wherever it appears.
The gift is never charged. If the discount is ever not making the gift free (for example if it is paused), the widget removes the gift from the cart rather than let a shopper be charged for it.
4. Checkout field & attribute rules
Require or restrict a cart attribute, custom field, or metafield before checkout. For example, require a delivery date that isn't in the past and isn't a Sunday, make a PO number mandatory, or only allow approved values. If a cart breaks a rule, the shopper sees a message you write and can't check out until it's fixed.
This rule reads data that is already on the cart. It checks cart attributes, line item properties, and metafields that your theme, a form, or a date picker writes. Make sure the field you want to check is actually being saved to the cart under a name you know, so the rule can read it.
Set it up
- In Parcel Rules, click Set up field rules (or go to Shopify admin, Settings, Checkout, Checkout rules, and add the Parcel Rules attribute & field validation).
- Pick a preset (delivery date, required field, allowed values, or format), choose the field to check, set the check and its value(s), and write the message shoppers see when the rule fails.
- Optionally limit the rule to specific products, collections, or countries, then Save the rule.
Settings reference
| Setting | What it does | Default |
|---|---|---|
| Field to check | The value the rule reads. Choose the source (cart attribute, line item property, shop metafield, or product metafield) and the field name. | Required |
| Check | What has to be true: the field is present (required) or empty, equals or does not equal a value, is one of an allow list or none of a block list, matches a format, or passes a date rule (not in the past, within the next N days, weekday is or isn't a given day). | Required |
| Value(s) | The value, list, pattern, or number of days the check compares against. Some checks (like “is present”) need no value. | Depends on the check |
| Apply to | Limit the rule to specific products, collections, or shipping countries. Leave empty to apply it to the whole cart. | Whole cart |
| Checkout error message | The blocking message shown at the top of checkout when the rule fails. Write it so the shopper knows how to fix it. | Required |
| Only check when the field has a value | Skip the rule when the field is empty, so an optional field is only validated once it is filled in. Leave off to make the field itself required. | Off |
| When to check | Cart and checkout also checks the rule when items are added to the cart or the cart is updated, so a failing rule can stop a product being added. Checkout only lets customers fill the cart first and checks the rule once they reach checkout. Use it for fields chosen on the cart page after items are added, such as a pick-up or delivery date. | Cart and checkout (new delivery date and required field rules start on Checkout only) |
You can add several rules. Every rule that applies to the cart has to pass before checkout can continue.
How it works
A Cart and Checkout Validation function reads the fields you chose and tests them against each rule every time the cart or checkout changes. If any rule fails, checkout is blocked with your message until the shopper fixes it. Because it runs inside Shopify's checkout, it works on Basic, Shopify, Advanced, and Plus, not just Plus.
Rules also run for express checkouts such as Shop Pay, Apple Pay, Google Pay and PayPal, so an order can't skip a required field by going straight to an express button. A checkout-only rule still applies there.
Test it on your storefront
- Add a product the rule applies to (or any product, if the rule applies to the whole cart), and set the field so it breaks the rule, for example a delivery date on a Sunday.
- Go to checkout. Checkout is blocked and your message is shown at the top.
- Fix the field, for example pick a weekday, and checkout proceeds normally.

Good to know: a rule only blocks when its field is in scope for the cart. If the field never gets written to the cart, a “required” check still blocks (the value is missing), while the other checks have nothing to test. Use the “only check when the field has a value” option for fields that are genuinely optional.
5. Delivery rate rules
Hide or reorder a delivery rate based on what is in the cart: once the spend on certain products reaches an amount, until it does, or unless the cart contains certain products. For example, hide standard shipping above a threshold so express becomes the only option, show a club rate only on carts with club kit, or move a rate up the list. Configured inside the Parcel Rules app, on the Delivery rate rules page.
Why this is separate from a discount. Shopify checkout pre-selects the shipping option by its base price, not its discounted price, so a free-shipping discount can make express free yet checkout still defaults to paid standard. Hiding the slower rate above the threshold makes the faster rate the only (hence selected) option.
Set it up
- In Parcel Rules, open Delivery rate rules and click Add a rule.
- Choose the mode, the rate(s) to act on (by name), the spend amount (not needed for the "unless the cart contains" mode), and the collections or products that count (under Included). For reorder, choose whether the rate(s) move to the top or the bottom of the list.
- Leave Enabled on and Create rule. Keep the threshold and the counted products identical to your matching free-shipping discount so the two agree. You can add more rules any time, and edit or delete them from the list.
Settings reference
| Setting | What it does | Default |
|---|---|---|
| Mode | Hide the rate(s) above the threshold removes them once the counted subtotal reaches the threshold. Hide the rate(s) below the threshold removes them until the counted subtotal (before discounts) reaches it, so a cart with no counted product also hides them (a minimum-spend rate). Hide the rate(s) unless the cart contains counted products removes them when no counted product is in the cart. Move puts them at the top or bottom of the list. | Hide |
| Delivery rate(s) to act on | The checkout rate(s) to hide or move, matched by name. Pick from your active rates or type a name. | Required |
| Also act on in-store pickup options (below and unless modes) | When on, an in-store pickup option whose name matches (the pickup location's name as shown at checkout) is hidden too, for example a seasonal pickup location you only want offered when the cart holds certain products. Local delivery and Pickup Points are never affected. The above-threshold hide and move modes already act on any option with a matching name, so they don't show this setting. | Off |
| Spend amount (the threshold) | The spend on counting products the rule compares against. Not used by "unless the cart contains counted products". | Required |
| Position (reorder only) | Whether to move the rate(s) to the top or the bottom of the list. | Top of the list |
| Included collections / products (shown as "Products that count" in the unless mode) | The products whose spend counts toward the amount, or whose presence keeps the rate in "unless the cart contains counted products". | Every product counts (the unless mode needs at least one chosen) |
| Excluded collections / products | Products that never count, even if they sit in an included collection. | Nothing excluded |
| Enabled | When off, the rule stays saved but doesn't run at checkout. | On |
You can add several rules (up to 25 per store). Each rule is independent, with its own products, threshold, mode, and rates, and can be edited or deleted from the list.
Worked example: show a bulk or club rate only on carts with club kit
Say you offer a free "Team bulk delivery" rate, but only for custom club kit. Add a rule with these settings:
| Setting | Value |
|---|---|
| Mode | Hide the rate(s) unless the cart contains counted products |
| Delivery rate(s) | Team bulk delivery |
| Included collections | Your custom kit collection |
| Excluded | Nothing |
A cart with only regular kit won't see Team bulk delivery. A cart with custom kit (with or without other items) will. It counts the quantity of custom kit, not its spend, so a custom item that is free or fully discounted still keeps the rate. Make sure no unrelated product sits in the counted collection, or it will count as custom kit too.
How it works
A Delivery Customization function adds up the value of the counting lines (before discounts) and, once that subtotal reaches your threshold (or falls below it, or the cart holds no counted products, depending on the mode), hides or reorders the named rate(s). The "below" and "unless the cart contains" modes affect shipping rates, plus in-store pickup options when you turn on Also act on in-store pickup options. They never affect local delivery or Pickup Points. They leave a shipping rate in place when no other shipping rate would remain (a pickup option doesn't count as one), and they only hide a pickup option while at least one other option stays in the delivery group, which can be a shipping rate, so a rule can hide every pickup location for that cart. The older hide and reorder modes match by name across every rate type.
Hide never removes the last remaining rate in a delivery group, so checkout can't be left with no shipping option. Each rule checks this on its own, so when several rules apply to one cart, each one that matches hides its rates and rules that together hide every rate or pickup option a cart could be offered can still leave none. Reorder changes display order only: Shopify still auto-selects the cheapest rate as the default, so use hide to force an option. Because it runs inside Shopify's checkout, it works on Basic, Shopify, Advanced, and Plus, not just Plus.
Test it on your storefront
- Add counting products until the cart reaches your threshold, then go to checkout and enter a shipping address.
- In hide mode, the named rate disappears and the remaining rate is selected. In reorder mode, the named rate moves to your chosen position.
- Drop below the threshold (or, for "unless the cart contains", add or remove a counted product), and the rate returns to its normal place.
Good to know: rate names must match exactly as they appear at checkout. Keep the threshold and counted products the same as your free-shipping discount, or the two will trigger at different cart values and disagree.
Frequently asked questions
Which Shopify plans does Parcel Rules work on?
All of them. Every feature is powered by Shopify Functions, so your rules run natively at checkout on Basic, Shopify, Advanced, and Plus, not just Plus.
Do I have to set up every feature?
No. The features are independent, so set up only the ones you need and leave the rest alone.
Where do I configure each feature?
Free shipping by collection and free gift with purchase are Shopify discounts, set up in Discounts. Delivery zones by postcode and checkout field rules are checkout rules, set up in Settings, Checkout, Checkout rules. Delivery rate rules are configured inside the Parcel Rules app, on the Delivery rate rules page.
Can I offer free shipping on one collection without the whole cart qualifying?
Yes. Give a collection its own threshold that is counted separately from the rest of the cart, so the eligible products ship free while other items keep their normal rates. Those products need their own shipping profile with its own delivery rate.
Is the free gift ever charged to the customer?
No. The discount function is the authority on pricing and keeps the gift free at checkout. If the gift is ever not discounted to free, the storefront widget removes it from the cart rather than let a shopper be charged.
Does the free gift work on any theme?
The storefront widget that adds the gift needs an Online Store 2.0 theme, where you enable the Gift with purchase app embed. The discount function still keeps the gift free wherever it appears.
What can checkout field rules check?
Cart attributes, line item properties, and shop or product metafields. You can require a field, allow or block specific values, enforce a format, or apply date rules such as not in the past, within the next few days, or specific weekdays.
Does Shopify do collection shipping thresholds natively?
Shopify is rolling out market-driven shipping, which can set collection-based shipping thresholds natively, counting a collection's subtotal on its own. If your store is on it, you may not need the free shipping by collection rule for a simple free-over-threshold offer, and we flag that on the app home page. Parcel Rules still helps if you want to exclude products from the count, scope by specific products, apply a partial discount, or you haven't moved to market-driven shipping yet. The app's other features (free gift, delivery zones, checkout field rules, delivery rate rules) aren't part of market-driven shipping.
Still need help?
Send us a message and we will help you get set up. We usually reply within one business day.