ℹ️ 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.
Fixing HS Codes
Click Fix HS Codes on the HS Code score card.
Compliance Hub identifies products with a missing or incorrect HS Code and retrieves the correct six-digit code for each.
Click Sync Fixes to Store to push the corrected codes to your store.
⚠️ Once synced, HS Codes can't be reverted automatically.
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, Compliance Hub only compares the first six digits. 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 using 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.