What is Product-Based Shipping Rate?

Product-Based Shipping Rate refers to any shipping rate created using the options under “By Product Surcharge”.

These options include rules based on Product, Variant, Product Type, Collection ID, Vendor, Product Tag, Product SKU, or Variant Metafield.

Only product-based shipping rates and ignore the rest

If we enable this option and all line items of the cart with an assigned shipping rate are based on the product, then it will display only product-based shipping rates and ignore the rest (ex: Price and Weight-based rate).

If we set this option as Yes, then it will show all rates.

EX:

• Product A shipping – product based – $10
• Product B shipping – weight based – $20
• Product C shipping – price based – $30
• If we set this option as Yes and add products A, B, and C into the cart then the shipping rate is $10.

If we set this option as No, then it will show all rates.

EX:

• Product A shipping – product based – $10
• Product B shipping – weight based – $20
• Product C shipping – price based – $30

If we set this option as No and add products A, B, and C into the cart then the shipping rate is product based – $10, weight-based – $20, price based – $30

---

Multiply the product base rate price if multiple items in the cart

If multiple items in the cart are linked to a single product rate, the base rate will be multiplied by the number of line items, not by the total quantity.

Ex:

You have a shipping rate with a base price of $10. You add three different items to the cart: Product A, Product B, and Product C — all using the same product rate.

• If the option is set to Yes, the base price will be calculated as:
  3 × $10 = $30 (base price is applied per line item).
• If the option is set to No, the base price will remain $10, regardless of the number of line items.

---

Set based on product and if in the cart some line item comes without the set rate

If product-based shipping rates are set for your store in our app, and some line items in the cart are not eligible for product-based rates, how should the app behave?

EX:

Product A and Product B has set the rate from the application but product C don’t have any rate.

Now when we add Product A and product C to my cart.

If we set this option as Yes then the app will send the rate of the A even the product C doesn’t have any shipping rate.

If we set this option as No then the app will send the error message cause one of the product in the cart(Product C) doesn’t have any rate.

---

Counts only the selected item’s weight or quantity or price if the item is in the cart instead of the cart total

Rate rule counts only the selected item’s weight or quantity or price if the item is in the cart instead of the cart.

EX:

If I create a shipping rate for the products A, B, C, D and rule like below.

• $0-$50 cart subtotal then $10
• $51-$100 cart subtotal then $20
• Product price
• Product A – $10
• Product B – $20
• Product X – $10
• Product Y – $20
• Product Z – $30

If my cart has A, B, X, Y, Z products in my cart and my cart total is $90

If we set this option as Yes then it will take the total of only the product which is included with the rate and send the shipping rate as per the above condition.

Product A and B is included with the rate so it take the total of A and B which is $30 so as per the rule it will send $10 shipping rate.

If we set this option as No then it will take the subtotal of the cart and send the rate even product X, Y, Z is not included with the rate.

So here the total is $90 and as per the rule it will send the shipping rate $20.

Note: If the same product is used to create two or more product-based shipping rates, the product’s weight, price, or quantity will be used for each of those rates.

Exclude Product-Based Shipping from Regular Shipping Rates

If a cart contains a mix of products—some with product-based shipping rates and some without—this setting determines how regular rates (like weight-based or price-based shipping) are calculated.

When enabled:

Products with their own product-based shipping rates are excluded from regular shipping calculations.

Only the remaining products (without a product-based rate) contribute to weight-based or price-based shipping charges.

Example:

• Product A has a product-based shipping rate.
• Product B does not, and shipping is calculated based on weight.

If this setting is enabled, only Product B’s weight is used to calculate weight-based shipping.

If this setting is disabled, the total weight of A + B will be used for the weight-based shipping calculation (even though A already has its own rate).

Restrict Product-Based Rates by Zip Code

This setting controls how product-based shipping rates behave based on the customer’s zip code.

If this setting is set to “Yes” and there is a product in the cart with a product-based rate, and the customer enters the zipcode of that rate, then this rate will be shown along with other applicable rates.

If the customer enters a zipcode other than the zipcodes of that rate, then this rate will not be shown and other applicable rates will not be shown.

If this setting is set to “No” and there is a product in the cart with a product-based rate, and the customer enters the zipcode of that rate, then this rate will be shown along with other applicable rates.

If the customer enters a zipcode other than the zipcodes of that rate, then this rate will be shown and other applicable rates will not be shown.

Execution Order: Exclude Rate vs. Reduce Conditions

This setting controls the sequence of two key operations in shipping rate calculation:

Exclude rate for products

Reduce only product price, weight, and quantity

You can choose whether to apply the exclude rate logic before or after the reduction of product attributes.

Options:

After (Recommended):

First, product price, weight, and quantity are reduced.

Then, the rate for those products is excluded.

Ensures that reduction logic is respected before final rate exclusion.

Before:

First, the rate for the product is excluded.

Then, the reduction of product price, weight, and quantity happens.

This may lead to different results if exclusions remove products before conditions apply.

Example:

Let’s say Product A has:

Weight: 5 kg

Product-based rate assigned

Scenario:

A rule reduces weight by 50% if the product qualifies.

You also want to exclude this product from weight-based shipping.

If “After” is selected:

Product weight becomes 2.5 kg after reduction.

Then, it is excluded from weight-based calculation (effectively not counted).

If “Before” is selected:

Product is excluded first (still at 5 kg), so reduction doesn’t matter.

May result in unintended calculations if reduction conditions should apply.

Rate Based On/Surcharge ➝ Surcharge Count From requires minimum qty?

This setting controls when the surcharge should start applying based on item quantity.

If set to Yes:

The surcharge applies only when the customer buys the minimum quantity or more.

Example:
If “Surcharge Count From” is set to 5:

Buying 3 units → No surcharge shown

Buying 5 or more units → Surcharge is shown

If set to No:

The surcharge is shown regardless of quantity.

Example:
Even if the customer buys 1 unit, the surcharge will be applied.

Do you want to multiply quantity in per product condition?

This setting controls whether the Total Price and Weight in per-product conditions should be multiplied by the product quantity in the cart.

If set to Yes:

The Total and Weight values are multiplied by quantity.

Example:

• If product price is $100 and quantity is 3 → Total = $300
• If product weight is 2kg and quantity is 3 → Total weight = 6kg

If set to No:

The values are not multiplied by quantity—only single unit values are considered.

Example:

• Price = $100, Weight = 2kg → Always counted as $100 and 2kg regardless of quantity