Set a fixed weight on every matched variant, or shift each variant's existing weight up or down by the same amount. Useful when you've finally weighed your stock, when you're switching units in a way the unit field can't fix on its own, or when packaging changes add the same overhead across a catalog.

Weight is a variant field. Each product variant has its own weight, so the action runs once per matched variant. A product with three variants gets three weight updates.

The number is in each variant's own weight unit (kg, g, lb, or oz). The form shows a plain number with no unit suffix — 1.5 means 1.5 in whatever unit the variant is already configured to use. If you need to convert units across the catalog, edit the Weight Unit field separately; values aren't converted automatically.

Step 1: Pick the Weight field

In the Configure Product Edits panel, click Select Field.

The Configure Product Edits panel with the Select Field button outlined

Weight lives under Variant Fields as Weight (in product's unit). Type weight in the search to filter the list down.

Select Field modal filtered to "weight", showing Weight (in product's unit) and Weight Unit

Click Weight (in product's unit). The configuration panel switches to a How to edit dropdown defaulting to Set weight to value, plus a number input.

Configuration panel after picking Weight: How to edit set to Set weight to value, with a 0 in the Set weight to input

Step 2: Choose how to change the weight

Two actions are available.

Set weight to value — every matched variant becomes this exact weight, regardless of its current value.
Change weight by amount — add a number to each variant's existing weight. Use a negative number to subtract.

That's it — there's no percentage option, no rounding, no "set to null" for weight.

Step 3: Enter the value

Set weight to value

Type the new weight in the Set weight to input. The Edit Preview on the right shows the original value struck through and the new value alongside it for every matched variant.

Set weight to 1.5 with preview showing variants updating from their current weight to 1.5

Setting a fixed weight overwrites every matched variant with the same number. If your variants are in mixed units, you'll end up with 1.5 kg for some and 1.5 lb for others. Filter or check the unit before running.

Change weight by amount

Type the amount to add. The label still reads "Set weight to" — that's just the form label — but the math is additive: current weight + your value. Use a negative number to decrease.

Change weight by amount selected with 1.5 entered; preview shows current weight (e.g. 0.0992 → 1.5992 and 62.0006 → 63.5006) with the original struck through

Variants with no weight set (0) become exactly your input value when you adjust by amount — 0 + 1.5 = 1.5. If you don't want to touch un-weighed variants, add a filter that requires Weight to be greater than 0.

After the run

Weight changes are reversible from the History page using Undo.
Change weight by amount is not idempotent — re-running it adds the amount again. A +1.5 re-run on a 1.5 kg variant yields 3 kg, then 4.5 kg, etc.
Weight is stored separately from Weight Unit. Editing one doesn't change the other. If you're switching from pounds to kilograms across the catalog, run two edits — one for the unit, one for the value — and remember the value won't be converted automatically.
Variants with requiresShipping = false (digital products, services) ignore weight entirely on the storefront, but the field will still be updated in the admin.