How to add an HS code for Shopify products
The HS code for Shopify products is set per variant, inside the Customs information subsection of the Shipping card — collapsed by default, which is why most merchants never find it. There are three documented ways to fill it in and a fourth via CSV. The right one depends entirely on how many products you have. Here are the exact paths.
Method 1: on the product page
- From the Shopify admin, go to Products.
- Open the product.
- Scroll to the Shipping section.
- Click Country of origin and choose the country or region where the product was made.
- In Harmonized System (HS) code, enter the code.
- Save.
Best for: new products as you add them, and stores under roughly 50 SKUs. Both customs fields sit in the same place, so do them together — a label needs both.
Method 2: the bulk editor
- Go to Products.
- Select the products you want to edit.
- Click Bulk edit.
- Click Columns and add Harmonized system code.
- Type values into the grid and save.
Best for: a known list of products, up to a few hundred. The limitation is in step 2 — you have to already know which products to select, and Shopify gives you no way to filter by "HS code is empty".
There is a second, more capable bulk editor worth knowing about. Products > Inventory > select variants > Edit variants > Columns opens the inventory bulk editor, where Shopify documents Harmonized system code, Country of origin and Weight as editable variant properties — all three customs fields in one grid. The same "you must already know what to select" limit applies, and variants set not to track quantity don't appear on the Inventory page at all.
Method 3: the inventory CSV
Products > Inventory > Export produces a file with an HS Code column and a COO column for country of origin. Fill them in, then Products > Inventory > Import to write them back.
Method 4: at label purchase
Shopify also lets you supply a code while buying a shipping label. It unblocks the parcel in front of you and changes nothing about the catalogue, so the next order for the same product asks again. Treat it as triage, not a fix.
Which method for which store
| Catalogue | You know what is missing | You do not |
|---|---|---|
| Under 50 variants | Product page | Skim the product list by hand |
| 50-500 variants | Bulk editor | Export inventory CSV, filter for blanks |
| 500-5,000 variants | Inventory CSV | Audit tool, then CSV or bulk editor |
| 5,000+ variants | CSV or app with grouping | Audit tool first — manual review is not realistic |
Getting the code right, not just entered
Entering a code is the easy half. Two rules that prevent the common failures:
- Six digits minimum, even number of digits. Four digits or five digits is the malformation behind the "Harmonized code is invalid" error.
- Classify by what the product is, not what it is for. A silicone phone case and a leather one are different headings. Grouping by store collection produces confidently wrong data.
Look codes up at the official HTS. For products where the classification is genuinely arguable — and there are more of those than most sellers expect — a licensed customs broker is worth the hour.
The short version
Product page for a few, bulk editor for a known list, inventory CSV for a lot. The hard part is not entering codes; it is finding out which of your variants do not have one. See finding products missing HS codes.
Finding the HS code for Shopify products you didn't classify
Entering the code is the easy half. Deciding which code is the half no app should do for you, and Origova does not — it checks that a code is present and structurally valid (6–10 digits), never that it is the correct classification for your goods.
For US imports, the authoritative source is the Harmonized Tariff Schedule; past agency decisions on similar goods are searchable in CBP's rulings database. For genuinely ambiguous goods, that is a licensed customs broker's question. Our category walk-throughs cover the common cases: clothing and apparel, jewelry, cosmetics and skincare, footwear and toys.
Frequently asked questions
Where is the HS code field in Shopify?
From the Shopify admin, go to Products, open a product, and scroll to the Shipping section. It holds a Country of origin dropdown and a Harmonized System (HS) code field.
How do I add HS codes to many products at once?
Shopify documents the bulk editor: Products, select the items, click Bulk edit, then Columns, then add Harmonized system code. For larger jobs the inventory CSV carries an HS Code column.
How many digits should a Shopify HS code be?
At least six. The first six digits are the international part of the Harmonized System; countries add their own digits after that. Shopify's InventoryItem stores a six-digit HS code and can hold country-specific codes separately.
Do I need an HS code for every variant?
Yes, if the variants ship internationally. The field lives on the inventory item, so each variant carries its own value -- a 6-size, 8-colour product is 48 records.
What happens if I skip HS codes?
Shopify says duty calculations fall back to the product's description and category, which it describes as less accurate, and warns that inaccurate information may result in extra duties charged to the customer on delivery. Carriers may also reject or delay the shipment.
Where is the HS code for Shopify products stored?
On the variant’s inventory item, not on the product record — which is why the standard product CSV has no HS code column and why a GraphQL mutation has to set it through the inventory item. In the admin it appears under Shipping > Customs information, per variant.
Does every Shopify product need an HS code?
Every physical product you ship across a border does. Digital products, services and gift cards do not — mark them as not requiring shipping and they drop out of the check entirely. If Shopify is asking for a code on a domestic order, that has a separate cause.
Sources for this page: Shopify: Adding HS codes to your products · Shopify: Inventory CSV · Shopify: Adjusting inventory quantities in bulk · Shopify: Duties and taxes for markets · USITC HTS
Related: What is an HS code? · Bulk-add HS codes, 5 ways · Shopify product CSV and HS codes · Shopify HS code app