This article explains how Swap Label Printer ingests product data like HS codes and country of origin, and how to upload or backfill it yourself using a CSV.
Why you need to keep this up to date
Orders Hub needs an HS code and country of origin (COO) on a product before it can build the request it sends to Swap to generate a shipping label and customs paperwork. Without them, the order can't be processed.
💡 The HS codes and COO on your label and Commercial Invoice may differ from what you see in Orders Hub. This is expected — Swap will run a check on your compliance data before generating the label and ensure the most up-to-date, accurate and customs-friendly data are used on your customs paperwork.
How product data gets into your label portal
When your portal is first configured, your Onboarding Manager will ensure that Orders Hub imports your Shopify inventory and that all your product data is uploaded successfully.
After that — Orders Hub only receives product data at the moment a product is created in Shopify. If you add an HS code or country of origin to a product after it's already been created, Orders Hub won't pick up the change automatically. The same goes for any other edits to an existing product.
Follow the below steps to ensure your product data is kept up to date on an ongoing basis.
Setting a default HS code
You can set a default HS code for new products under Settings → Defaults. There's currently no default setting for country of origin, so COO always needs to be set at the product level (see below).
Uploading or backfilling product data
Follow the process below whenever you need to upload HS codes, country of origin, or other product information.
Preparing your file
To import data from Shopify, export it from Shopify → Products → Inventory → Export, selecting all variants.
You can select the columns you want to map — at minimum SKU, plus whichever fields you're uploading (for example HS code or country of origin).
Check the file for:
No duplicate or blank SKUs
No unnecessary columns
No characters your spreadsheet tool might not handle cleanly — saving as UTF-8 avoids most issues with special characters in product names or descriptions
💡 Product weights and custom descriptions must be uploaded in two separate files. If you want to upload product weights to the portal, you must take your Shopify export from Products → Export. If you don't want to do this, you can set a default product weight in the portal under Settings → General Settings → Defaults.
Uploading the file
Open your Orders Hub, then go to Inventory.
2. Select Import/Export Inventory.
3. Click Select file, choose your prepared file, then click Upload and Process File.
4. Map each column to the correct field — for example, map your SKU column to Product Code.
5. If there were no issues with the file, you'll see a confirmation message.
If there's an issue, the error will tell you which SKUs are affected — if no SKU is listed, check for a blank SKU row and remove it.
💡 Orders Hub remembers your column mapping from your last upload. If your file's structure has changed since then, double-check the mapping before submitting.
Uploaded data only applies to new orders created after the upload — it won't retroactively update orders that are already sitting in Orders Hub.
Exporting your current inventory
You can export your existing Orders Hub inventory to CSV from the same Import/Export Inventory page. This is useful for reviewing what data you already have, getting a pre-filled template to add missing fields to, or keeping a backup before making bulk changes.