PREFLIGHT CHECK

Shopify Weight CSV Checker

Check integer gram weight values and display units g, kg, lb or oz in Shopify product CSV files before import.

Check CSV

🔒 Analysis runs in your browser; the file itself is not sent to BlueprintLab.

What this tool checks

  • Integer gram values
  • g / kg / lb / oz
  • Unit-suffixed or decimal values

What it cannot determine

This unofficial checker covers only rules that can be verified in the browser. Live account settings, remote server state and later service-side validation remain authoritative.

How to use this tool

Check integer gram weight values and display units g, kg, lb or oz in Shopify product CSV files.

  1. Use Try sample to inspect the included sample.
  2. Set + Choose a CSV file Tap/click to choose. Drag and drop also works on desktop..
  3. Use Check CSV to process the input.
  4. Compare the result with your source data and return to the input to make corrections.
+ Choose a CSV file Tap/click to choose. Drag and drop also works on desktop.
.csv,text/csv

Input and settings example

URL handle,Title,Weight value (grams),Weight unit for display
sample-shirt,Sample Shirt,250,g

This is not the column where you type “5.125 kg”

`Weight value (grams)` stores an integer number of grams with no unit and no decimal point. A 5.125 kg variant becomes `5125`; Shopify’s own example converts four pounds to `1814`.

The checker rejects unit-bearing text and decimals because they do not match the CSV field definition.

The display unit and the stored weight value are separate

`Weight unit for display` controls how weight is shown and accepts `g`, `kg`, `lb`, or `oz`. The numeric weight field is still grams regardless of the display unit.

When left blank, Shopify documents a default weight value of 0 and a default display unit of kg. A blank is therefore a default choice, not simply an unknown value.

Correct syntax does not prove the weight itself is correct

A value of `5125` can be perfectly valid CSV and still be a data-entry mistake. Carrier-calculated rates and third-party fulfillment can amplify a one-digit error into a shipping-cost problem.

Treat zero errors as a format check, then compare unusually large or small values with the source product data.

Weight often belongs in the same review as fulfillment

If the same CSV also changes who fulfills the variant, run the Shopify Fulfillment service checker. Weight and fulfillment are separate columns, but they often affect the same shipping workflow.