Shipping rules and markups field reference
Every field in the shipping rule editor and the markup editor, what it does, and an example of each. For the ideas behind them, start with How shipping rules work.
Advanced · Reference
Shared = the field belongs to the whole method: saving any rule copies it to every rule with the same method number.
Rule editor: Basics
| Field |
Values |
Shared |
Example → result |
| Method name |
Text. Spaces at the start and end are removed. BigCommerce: up to 100 characters. Turbify: must match the Turbify method name. |
Yes |
UPS Ground → shoppers see "UPS Ground". A new rule with an existing name joins that method. |
| Method description |
Shopify: text, HTML removed, & saved as "and". BigCommerce: up to 125 characters. |
Yes |
Arrives in 3–5 business days → shown under the name. |
| Delivery estimate text |
Text. Only with a delivery-estimate add-on. |
Yes |
Overrides the global delivery estimate text for this method. |
Rule editor: When this rule applies
Leave a box empty for no limit. Both ends of a range are included.
| Field |
Compares |
Example → result |
| Weight (min to max) |
Weight of the products being priced (free and flat-rated products left out, unless counted in Settings). Max is also the most one package can weigh. |
0 to 1 → a 1 lb cart matches; 1.2 lb doesn't. |
| Split the package if over |
Instead of not matching, heavier carts are split into packages up to the max weight. Needs a max weight; can't be used with a min weight. |
Max 70, ticked → a 160 lb cart is rated as three packages. |
| Order value (min to max) |
Value of the products. Coupon subtracted first if set in Settings. |
75 to (empty) → an order of exactly $75.00 matches. |
| Distance (add-on) |
Miles or kilometers from origin to destination. |
0 to 25 → local only. |
| Points (add-on) |
The cart's total points: product points × quantity, added up. |
Max 20000; 4 × 5,400-point items = 21,600 → doesn't match. |
Rule editor: Where it ships
| Field |
Values |
Example → result |
| Origin ZIP code |
One ZIP code. The rule applies only if a product ships from it, and prices only those packages. Your store's own origin ZIP is cleared on save. |
33467 → card shows "(originating at 33467)". |
| Destination ZIP code |
One code, or a numeric range FROM-TO. |
33400-33499 → 33450 matches; 33500 doesn't. |
| Destination ZIP codes (if turned on by support) |
List. A partial code matches every code starting with it; any case. |
902 → 90210 matches. |
| Exclude destination ZIP codes (if turned on by support) |
List, same matching. The rule never applies to these. |
995 → 99501 excluded. |
| Country |
Inside + list, Outside + list, Anywhere. |
Outside, United States → international only. |
| States / provinces |
All, 48 states + DC, US territories, Choose + list. |
48 states + DC → not AK, HI or territories. |
| PO boxes |
Allow, Block. |
Block → "P.O. Box 12" doesn't match. |
| Residence type (if turned on by support) |
All addresses, Residential only, Commercial only. |
Residential only → business addresses don't match. |
Rule editor: Products and customers
| Field |
Effect |
| Ignore product origin ZIP codes |
Every product treated as shipping from your main origin for this rule. |
| Ignore product 'Multi-Box' |
Products' multi-box setup is ignored when packing for this rule. |
| Ignore product 'Dimensions' |
Packs by weight only for this rule. |
| Ignore product 'Ship-Alone' |
Ship-alone products may share boxes for this rule. |
| Ignore product 'Item-Points' (add-on) |
Product points ignored for this rule. |
| For Customer Tag / For Customer Group (add-on) |
Rule applies only to customers with one of these tags. Whole tag, any case. |
| Exclude Customer Tag / Exclude Customer Group (add-on) |
Rule never applies to customers with one of these tags. |
| Customer attribute value (BigCommerce B2B, turned on by support) |
Rule applies only when the customer's attribute equals this value. |
Rule editor: How it's priced
HazMat charge (add-on): an amount added when the cart has hazmat items.
Real-time
| Field |
Values |
| Assigned method |
The carrier service whose live rate is used. Each package is rated and the rates added. |
| Packaging override |
Use Global Setting, a UPS type (UPS Letter/Express Envelope, Package, UPS Tube, UPS Pak, UPS Express Box, UPS 25KG Box, UPS 10KG Box, Pallet) or a FedEx type (Your Packaging, FedEx Envelope, FedEx Pak, FedEx Tube, FedEx Box, FedEx 10KG Box, FedEx 25KG Box, plus FedEx One boxes when available). |
| FedEx One |
Shown for some FedEx services when FedEx One is available. |
| Saturday delivery + Active on days |
Shown for some overnight and express services. The rule applies only on the ticked weekdays. No days ticked → never shows. |
Percentage or flat
All filled boxes are added.
| Field |
Example → result |
| Percentage of order |
10, $80 order → $8.00 |
| Flat rate to total |
7.95 → $7.95 |
| Flat rate per product |
2, 3 units → $6.00 |
| Flat rate per Pound (your weight unit) |
1.50, 6 lb → $9.00 |
| Flat rate per mile (add-on) |
0.50, 20 miles → $10.00 |
| Flat rate per point (add-on) |
0.01, 800 points → $8.00 |
Combined: Percentage of order 10 + Flat rate to total 5, $80 order → $13.00.
Table
| Field |
Values |
| Basis |
Amount, Amount (Percentage), Weight, Products; with add-ons Points and a distance basis. |
| From / Charge |
One tier per row. The last row whose From ≤ the value is used. Start at 0, smallest first. |
| OR Real-Time Shipping Charge |
Instead of a charge, price that tier with a live carrier service. |
Tables are looked up and charged per packed box.
| Basis |
Table |
Box |
Charge |
| Weight |
0 → 8.95, 5 → 12.95, 20 → 24.95 |
7 lb |
$12.95 |
| Products |
0 → 5.00, 3 → 8.00 |
4 units |
$8.00 |
| Amount |
0 → 9.99, 50 → 4.99, 100 → 0 |
$60 of products |
$4.99 |
| Amount (Percentage) |
0 → 10, 100 → 5 |
$120 of products |
5% = $6.00 |
| Amount |
0 → (OR UPS Ground), 150 → 0 |
$90 of products |
live UPS Ground rate |
The rule card shows tiers as "0 - 4.99", "5 - 19.99", "20 and up". With Base table-amount shipping rules on set to Order value in Settings, Amount tables use the whole order's value.
Rule editor: Free shipping (shared)
| Field |
Values |
Example → result |
| Free shipping over |
Amount. Order value must be more than it. |
75 → $75.00 not free; $75.01 free. |
| Subtract coupons |
On (default) / off. On: discounts subtracted first. |
$80 order, $10 coupon, on → $70 → not free. |
| Valid only to |
48 States (default, includes DC), 48 States, AK, HI, 48 States, AK, HI, Territories, All Countries; Canada- and Australia-origin stores get extra options. |
48 States → Alaska pays. |
| Max weight allowed |
Weight. Empty = no limit. |
50 → a 60 lb cart pays. |
| Free only with code (only on some stores) |
A coupon code. The whole rule applies only when the shopper uses it; any case. |
See Offer free shipping with a coupon code. |
Rule editor: Charges and options
| Field |
Shared |
Effect |
| Minimum charge |
Yes |
Final price raised to this. Not applied to a free $0 rate. |
| Maximum charge |
Yes |
Final price capped at this. |
| Note |
No |
Internal use only. Shown on the rule card, never at checkout. |
| Duties & taxes (add-on) |
Yes |
Off → duties and taxes aren't added for this method. |
Rule editor: Advanced triggers (shared, except Products with a tag)
See Advanced triggers reference for every trigger with examples.
What the rule card says
| Card text |
Meaning |
| "#3 UPS Ground (originating at 33467)" |
Method number, name, and the rule's Origin ZIP code |
| "Inside United States", "48 states", "US Territories", "Any state or province" |
Country and States / provinces |
| ", blocks PO boxes" |
PO boxes = Block |
| "Destination zip codes: …", "Except zip codes: …" |
ZIP code fields and lists |
| "Residential addresses only" |
Residence type |
| "Ignores product origin ZIP codes" |
That switch is on |
| "Free shipping over: $75 (valid to 48 states), up to 50 lbs." |
Free shipping card |
| "Maximum weight (split into more packages when over)" |
Split the package if over is ticked |
| "Saturday delivery: No days chosen" |
Saturday delivery on with no days — never shows |
| "Real-time rate: …", "Order percentage", "Order surcharge", "Per product", "Per pound" |
How it's priced |
| "Hide if #3 applies", "Show only if the rate is lower than #2's; when this shows, #2 is hidden" |
Advanced triggers |
| "Note: …" |
Internal note |
Markup editor
| Card / field |
Values |
Example → result |
| Basics → Shipping method |
A method with at least one rule switched on. Saved against one rule of it. |
— |
| When it applies → Origin ZIP code |
Applies only to packages from this origin. |
33467 |
| Destination ZIP code |
One code or a range like 33400-33499. |
33400-33499 |
| Country, States / provinces |
Same as rules. |
Inside, United States |
| Percentage or flat → Percentage of rate |
% of the shipping rate; minus for a markdown. |
15, $20 rate → +$3.00 |
| Flat rate per order |
Amount. |
2.50 → +$2.50 |
| Flat rate per product |
Amount × units. |
1, 3 units → +$3.00 |
| Flat rate per pound |
Amount × weight. |
0.25, 8 lb → +$2.00 |
| Table → Basis |
Amount, Amount (Percentage), Weight, Weight (Percentage), Products, Products (Percentage) |
See Vary a markup by amount, weight or number of products. |
| Packaging weight → From / Add |
Weight added to each package. |
0 → 0.5: a 4 lb package is rated at 4.5 lb. |
| Add at least … but no more than … |
Limits the amount the markup adds. |
10%, at least 1: $8 rate → +$1.00 |
All matching markups add up. Markups aren't added to a $0 rate, and are applied before Minimum charge and Maximum charge.
Product fields that use method numbers
Products refer to methods by number in Free shipping methods, Flat ship rates, Invalid ship methods and Markup. For their syntax, see Product markup and flat-rate syntax.
Messages shoppers may see
Default texts (Turbify stores can change them; see Customize shopper error messages (Turbify)):
| Message |
Usual cause |
| "Based on the items in your shopping cart, there was no match to any of the defined shipping rates." |
No rule of any method matched. |
| "The shipping method you chose is set to block PO Boxes. …" |
PO boxes = Block on the method's rules. |
| "One or more items in your cart are restricted not to ship to your shipping state." (or "country") |
A product's Exclude states or Exclude countries. |
| "One or more items in your cart are restricted not to use the shipping method that you chose." |
Often a product restriction, but not always. See "Restricted not to use the shipping method" — what it really means. |
| "There was a problem calculating the shipping rates for the items in your cart. …" |
For example, products from an origin that no rule covers. See Rules for products that ship from different origins. |
Rule editor messages
| Message |
Fix |
| "Please enter the shipping method's name exactly as it should appear in your checkout" |
Fill in Method name. |
| "Please select the countries relevant for this rule" |
Add a country, or pick Anywhere. |
| "Please select the states / provinces relevant for this rule" |
Add a state, or pick another option. |
| "Please enter the values you wish to calculate shipping with …" |
Fill in at least one Percentage or flat box. |
| "Please enter the charge for all populated "From" values …" |
Every table row with a From needs a charge or a live service. |
| "Please enter the "From" value for all populated charges …" |
Every table row with a charge needs a From. |
| "Methods with "Free Shipping Over" must have a minimum weight of 0 or left empty. …" |
Clear the minimum Weight. |
| "A package cannot be split when a minimum weight is set. …" |
Clear the minimum Weight to use Split the package if over. |
