Summary
The Compliance Hub is a section of the Swap merchant portal where you manage product-level compliance data for international shipping — including HS codes, Country of Origin, Manufacturer ID (MID) codes, and customs descriptions. This data is used to generate accurate customs documentation for your cross-border orders.
Access: The Compliance Hub is available to Admin users only. If you cannot see it in your portal, check your user role or contact your store Admin.
Accessing the Compliance Hub
Log in to your Swap merchant portal.
Navigate to Global → Operational → Compliance Hub.
First Step — Run the Health Check
When you open the Compliance Hub for the first time, your compliance scores will show as 0% or blank. This is expected — the system has not yet evaluated your product catalogue.
To get your scores:
Click the Run Health Check button in the top-right corner.
A modal will appear confirming the system will compile your Shopify product data and calculate your compliance score.
Click to confirm. The process takes a few seconds depending on catalogue size.
Once complete, your score cards will appear.
Compliance Score Cards
After running the Health Check, you will see score cards for each compliance attribute:
HS Code — product classification codes for duty calculations
Country of Origin (COO) — determines which duty rate applies
Unit Cost — required for B2B2C (Swap Clear) brands only
Manufacturer ID (MID Code) — required for customs documentation, especially for US-bound shipments
Custom Description — standardised product description used in customs paperwork
Each card shows:
✅ Compliant — products with valid data
⚠️ Action Required — products missing required information
Click Action Required on any card to filter the product table to only those items needing updates.
Fixing Each Score
HS Codes
HS Codes classify your products for international trade. Compliance Hub can identify and fix missing or incorrect codes automatically.
Click Fix HS Codes.
Review the products flagged as missing or requiring correction.
Click Sync Fixes to Store to apply the recommended codes to Shopify.
⚠️ Note: Once synced, HS Codes cannot be automatically reverted. Review carefully before applying.
If a product already has an HS Code but it appears incorrect, you will see a Fix Required icon. Hover over it to preview the suggested replacement before applying.
About 10-digit codes: If you have 10-digit HTS codes in Shopify, Compliance Hub only compares the first 6 digits. If those match, no fix is suggested. If they differ, the system will recommend an update.
Country of Origin (COO)
COO cannot be determined automatically — it must come from you.
Click Update Country of Origin.
Download the CSV template (contains Product ID, Product Title, Country of Origin).
Fill in the COO values and upload the file.
Once uploaded, COO updates in both Compliance Hub and Shopify, and the score updates automatically.
⚠️ If any rows in the CSV are missing a COO value, the upload will return an error. This prevents accidentally blanking existing data.
Unit Cost
Unit Cost is only relevant for brands using Swap Clear (B2B2C). If your store does not use B2B2C, you can ignore this score.
Click Update Unit Cost.
Download the CSV template.
Enter cost values and upload.
Manufacturer ID (MID Code)
MID codes are required on commercial invoices for customs clearance, particularly for US-bound shipments. Since Shopify does not have a native MID field, Compliance Hub creates and manages standardised Shopify metafields for you.
There are three ways to manage MID codes:
Option 1 - Auto-generate (single manufacturer)
Use this if all your products share the same manufacturer.
Select Automatic and click Next.
Enter manufacturer name, country, city, and address.
Click Generate MID Code, then Apply to All.
Option 2 - CSV upload (multiple manufacturers)
Use this if different products have different manufacturers.
Select Manual and download the CSV template.
Fill in the required columns: Product ID, Variant SKUs, Product Title, Manufacturer Name, Manufacturer Country, Manufacturer Address, and MID Code.
If you don't know the MID code, leave that column blank — Compliance Hub will generate it from the manufacturer details you provide.
Upload the CSV. MID codes are applied and synced to Shopify automatically.
Option 3 - Update directly in Shopify
You can enter MID codes directly into the Shopify metafields created by Compliance Hub.
⚠️ Important: If a MID code is entered directly in Shopify (not through Compliance Hub), it will not be validated or included in your Compliance Hub score. You are fully responsible for ensuring accuracy in this case.
Notes:
MID codes are managed at the product level, not variant level. All variants of a product share the same MID code and manufacturer details.
Do not create your own Shopify metafields for MID data — use the ones Compliance Hub creates automatically.
Custom Description
Custom descriptions are used in customs documentation to clearly identify what is being shipped. Compliance Hub manages these in a dedicated Shopify metafield.
There are three ways to add or update custom descriptions:
Option 1 - Generate with Swap AI (recommended for first-time setup)
Click Update Custom Description → Generate with Swap AI.
Click Generate Description.
Swap AI will generate descriptions for all products that don't already have one. Existing descriptions are never overwritten.
Option 2 - Bulk CSV upload
Click Update Custom Description → Update via CSV.
Download the template, fill in the Custom Description column, and upload.
Option 3 - Update in Shopify
Edit the Custom Description metafield directly on the product in Shopify. Changes sync back to Compliance Hub automatically.
Common Questions
Why are all my scores showing 0% when I first open the Compliance Hub?
This is expected. You need to run the Health Check (top-right corner) to trigger the initial evaluation. Scores will populate once the check is complete.
My Manufacturer ID score is 0% even though I've added MID codes in Shopify. Why?
MID codes added directly to Shopify outside of the Compliance Hub metafields are not validated by the system and will not count toward your score. To have them included, re-enter them via Compliance Hub (auto-generate or CSV upload).
Do I need to update compliance data at the variant level?
No. Compliance Hub manages data at the product level. All variants under the same product share the same HS Code, COO, MID code, and custom description.
Can I export my compliance data?
Yes. On each score card, you can download a CSV of the current data for that attribute at any time.
I have an alert or "Action Required" flag but I'm not sure what to do.
Click the flag to filter to the affected products. Follow the steps for the relevant score card above. If you're still unsure, contact Swap Support with a description of the issue.
The data in Compliance Hub looks incorrect.
Please report inaccuracies to Swap Technical Support so our team can investigate.