ℹ️ Compliance Hub is only accessible to Admin users.
This article walks you through fixing and updating your compliance data in Compliance Hub. For an overview of Compliance Hub and the compliance data it manages, see Understanding Compliance Hub.
Before you start
You'll need Admin access to your Swap Dashboard.
Run a Health Check in Compliance Hub first, so you know which products need fixes before you start. See Understanding Compliance Hub if you haven't already.
Checking Product Completeness
Click Complete product data on the Product completeness score card to open the Products needing action panel. It ranks products by cross-border demand and how much product data is missing from an HS10 classification perspective, so you know which to prioritise.
Each row shows a completeness status (Needs work or Fair), demand level, and the fields that are missing — most often Category, but low completeness can also point you toward running Generate Material Composition below. Click Update next to a product to fix the missing field in Shopify.
Generating Material Composition
Compliance Hub reads material composition data from your Shopify metafields. Click Generate material composition to have Compliance Hub fill in any gaps using your existing product information — this step doesn't push anything to Shopify, it only improves the data Compliance Hub itself uses for classification.
Material composition accuracy feeds directly into HS10 classification accuracy, and for some product categories it also determines whether extra compliance documentation is required. It's worth running this before Classifying HS10 if Product Completeness flags missing composition data.
Fixing HS Codes
The HS Codes score card now gives you four options, so you can choose how much to commit at each step instead of running everything at once.
Option 1: Classify HS10
Calculates a destination-specific, 10-digit code for each of your enabled markets (US, UK, EU, Canada, Australia). This step doesn't change anything in Shopify: it only generates the codes in Compliance Hub so you can review them before syncing.
Option 2: Sync HS6 to Shopify
Writes the recommended six-digit code to your product's main HS Code field in Shopify, replacing whatever is currently there.
Option 3: Sync HS10 to Shopify
Writes the classified 10-digit codes to each variant's country-specific fields in Shopify, under Customs information → HS code → By country, for US, UK, EU, Canada and Australia. This doesn't touch your main HS Code field.
Option 4: Fix & sync HS codes
Runs all of the above in one step: commits and syncs the recommended six-digit code, then classifies and syncs the 10-digit codes for every enabled market. Only use this if you're happy to accept Compliance Hub's recommendations across your whole catalogue.
⚠️ Once synced, HS Codes can't be reverted automatically.
⚠️ If you already have 8- or 10-digit codes in your main HS Code field, review them before running Fix & sync HS codes across your catalogue — it can overwrite that field with the recommended six-digit code.
If a product already has an HS Code but Compliance Hub flags it as incorrect, you'll see a Fix Required icon. Hover over it to see the suggested replacement before you apply the fix — the suggested classification is typically more accurate than a manually assigned one.
If your catalogue already uses 10-digit HTS codes in the main HS Code field, Compliance Hub only compares the first six digits when you run Sync HS6 to Shopify or Fix & sync HS codes. If they match, the existing code is accepted and no fix is suggested. If they don't match, applying the fix replaces the code with the recommended one at six digits.
Updating Country of Origin
Click Update Country of Origin on the Country of Origin score card.
Download the CSV template, which includes columns for Product ID, Product Title, and Country of Origin.
Add the Country of Origin value for each product.
Upload the completed file.
If any row is missing a Country of Origin value, the upload fails rather than overwriting existing data with a blank — fill in every row before uploading. Once the upload succeeds, Country of Origin updates in both Compliance Hub and your store's variant data, and your compliance score updates automatically.
Updating Unit Cost
Applies to Swap Clear (B2B2C) brands only. If you don't see Unit Cost options in your dashboard, this doesn't apply to your account.
Click Update Unit Cost on the Unit Cost score card.
Download the CSV template, which includes columns for Product ID, Product Title, and Unit Cost.
Enter the cost value for each product.
Upload the completed file.
As with Country of Origin, a row with a missing Unit Cost value will cause the upload to fail rather than overwrite existing data. Once uploaded, Unit Cost syncs back to your store (as Cost per item in Shopify) and is used to calculate duties on a cost-price-plus-5%-markup basis.
Managing manufacturer details and MID Codes
MID Codes and manufacturer details are managed at the product level — all variants of a product share the same values. Choose the option that matches how your catalogue is supplied.
Option 1: Generate automatically (single manufacturer)
Use this if every product in your catalogue comes from the same manufacturer.
Select Automatic, then click Next.
Enter the manufacturer's name, country, city, and address.
Click Generate MID Code.
Click Apply to All to assign the code to every product.
Option 2: Upload manufacturer details via CSV (multiple manufacturers)
Use this if your products come from different manufacturers.
Select Manual, then download the CSV template.
Fill in the manufacturer name, country, city, and address for each product, plus an Item Description and Custom Description if these aren't already set. If you don't already know the MID Code, leave that column blank — Compliance Hub generates it from the manufacturer details you provide.
Upload the completed CSV.
The template includes: Product ID, Variant SKUs, Product Title, MID Code, Manufacturer Name, Manufacturer Country, Manufacturer Address, Manufacturer City, Item Description, and Custom Description.
📝 Since this CSV also carries Custom Description, filling it in here has the same effect as the CSV method described in Managing Custom Descriptions below — you only need to do it once, whichever flow you're already using.
Option 3: Add MID Codes directly in your store
You can enter MID Codes and manufacturer details directly into the custom fields Compliance Hub creates in your store (metafields, if you're on Shopify), without
sing the generation or CSV options.
⚠️ MID Codes entered this way aren't validated or generated by Compliance Hub, and won't count toward your Manufacturer ID score. You're responsible for the accuracy of any details entered directly in your store.
How a MID Code is structured
If you want to check or troubleshoot a generated code, a MID Code follows this format:
A 2-letter country code (ISO format) — e.g. AU for Australia, GB for the United Kingdom.
Up to 6 letters from the manufacturer's name — one word uses its first 6 letters; multiple words take letters from each (non-alphabetic characters are ignored) until 6 are reached.
Up to 4 digits from the street address — the highest-value numbers if there's more than one, or none if the address has no numbers.
The first 3 letters of the city name.
For example, a manufacturer called Ozrock at 92 Alice Springs Road, Melbourne, Australia produces the code AUOZR92MEL.
Managing Custom Descriptions
Generate via Swap AI (recommended)
Click Update Customs Descriptions.
Click Generate Description.
Swap AI only generates descriptions for active products that don't already have one — it won't overwrite an existing description.
Bulk update via CSV
Click Update Custom Description, then select Update via CSV.
Download the CSV template and fill in the Custom Description column.
Upload the completed file.
Update directly in your store
You can also enter or edit a Custom Description directly in the custom field Compliance Hub creates on each product in your store. Changes made there are reflected back in Compliance Hub.
However you update it, a manually entered Custom Description always takes precedence over an AI-generated one.
Frequently asked questions
Can I update compliance fields directly in my e-commerce platform instead of using CSV uploads?
Most e-commerce platforms don't support straightforward bulk editing of fields like HS Code, Country of Origin, or Unit Cost — updating them natively usually means opening each product variant individually. The CSV upload flows in Compliance Hub are the recommended approach, especially during initial onboarding, though manufacturer details, MID Codes, and Custom Descriptions can also be managed directly in your store as described above.