Weight Rule

With weight rules, you can set a minimum or maximum value for the weight of eligible product variants registered in Shopify, and restrict purchases in the cart or at checkout. Weight is calculated by variant, product, or cart.

Note: Shopify allows up to 25 total enabled checkout rules per store, including rules enabled by other apps. Each enabled weight rule uses one of these.

Settings

The following settings are available for weight rules.

Field	Description
Title	An internal name that is not shown to customers.
Limit details	Minimum and maximum weight, weight unit, how to handle products with a different unit, and applicability.
Eligible items	The products the weight limit applies to.
Product message	The purchase condition shown on the product page (optional).
Alert message	The message shown when the limit is triggered.

Limit Details

Set the minimum and maximum weight, the unit, and how it's calculated.

Field	Description
Minimum weight	Restricts purchases below the set value. If not set, there is no lower limit.
Maximum weight	Restricts purchases above the set value. If not set, there is no upper limit.
Weight unit	Choose from Grams (g), Kilograms (kg), Ounces (oz), or Pounds (lb).
When product weight unit differs	Choose whether to convert it to the rule's unit and include it, or exclude it from the calculation.
Products with no weight set	Excluded from the weight calculation.
Applicability	Choose the unit for calculating weight from Variant, Product, or Cart.

For the differences between calculation units and examples, see "Applicability (Weight Rule)".

Eligible Items

Choose the range of products the weight limit applies to.

Setting	Applies to
All items	All products in your store.
Specific collections	Products or variants included in the selected collections (up to 50 collections).
Specific products	Selected products or variants (up to 50 products and 50 variants each).
Products with specific tags	Products with any of the specified tags (up to 50 tags, OR condition).

Note: If you select a collection that specifies products at the variant level, the weight limit applies only to the variants in the collection. However, the product message is shown on every variant of the product that the variant belongs to.

Product Message

The message shown above or below the cart button on the product page for eligible items. You can leave it blank if you don't want to state the purchase condition in advance.

Prerequisite: To display the product message, enable the app embed on your main theme. If you only use weight limits in the cart or at checkout, the app embed is not required.

The following variables can be used in the product message.

Variable	Description
{{minWeight}}	The minimum weight you set (with the unit).
{{maxWeight}}	The maximum weight you set (with the unit).

Alert Message

Set the message shown when the weight limit is triggered, and when it's displayed.

Display timing	Applies to
Cart updated and checkout	When the cart is updated and at checkout.
Checkout only	Checkout only.

The following variables can be used in the alert message.

Variable	Description
{{minWeight}}	The minimum weight you set (with the unit).
{{maxWeight}}	The maximum weight you set (with the unit).
{{currentWeight}}	The current weight calculated for the applicability unit (with the unit).

Enable or Disable the Rule

New weight rules are created in a disabled state. After saving, switch between enabled and disabled from the rule list or the edit screen.

Setting	Behavior
Enabled	Applies the purchase restriction from the weight rule.
Disabled	Does not apply the purchase restriction from the weight rule.