⚠️ Compliance Hub is only accessible to Admin users.

Compliance Hub is Swap's single source of truth for your product-level customs data. It pulls your active products from your e-commerce platform, checks them against the compliance information customs authorities require, and syncs any fixes back so your storefront and your shipments stay aligned.

When you open Compliance Hub for the first time, it imports all active products from your store automatically. Compliance scores show as 0% or blank until you run your first Health Check — that's expected, not an error.

Compliance Hub tracks five types of product data. Each one plays a different role in getting your shipments through customs.

A Harmonized System (HS) Code is a standardised number that classifies a product for customs and duty purposes. Swap recommends maintaining 6-digit HS Codes on your products — Swap expands these to a destination-specific 10-digit code automatically at checkout. If you provide your own code, its first six digits become the base classification duties and taxes are calculated from, so accuracy matters.

Country of Origin is the country a product is manufactured in, and it determines which duty rate applies. Unlike HS Codes, Swap can't determine COO automatically — you provide it, and Compliance Hub keeps it in sync with your store's Country of Origin field.

Applies to Swap Clear (B2B2C) brands only. Unit Cost is the cost per unit of a product, used to calculate duties on a cost-price-plus-5%-markup basis rather than full retail price. If your store doesn't use Swap Clear, you can ignore this score.

A MID Code identifies a product's manufacturer for customs documentation, and is required for many shipments into the United States. MID Codes are managed at the product level, so all variants of a product share the same manufacturer details and MID Code.

A Custom Description is a standardised, customs-ready description of a product, distinct from its storefront description. Compliance Hub creates and manages a dedicated custom field for this automatically — you don't need to build your own.

For step-by-step instructions on updating any of these, see How to manage your compliance data in Compliance Hub.

HS Code, Country of Origin, and Unit Cost correspond to native Shopify fields at the variant level. Manufacturer details, MID Code, and Custom Description don't have native Shopify fields, so Compliance Hub sets up standardised metafields for these instead. Use the metafields Compliance Hub provides rather than creating your own, to keep your data consistent and correctly mapped.

Running a Health Check — the button in the top-right corner of Compliance Hub — compares your product data against your compliance records and calculates a compliance score for each category. This can take a few seconds to a few minutes depending on the size of your catalogue, and other actions are paused while it runs.

After a Health Check, you'll see a score card for each category, split into Compliant and Action Required. Clicking Action Required filters the product table down to the items that need attention.

Auto Mode is off by default. When it's off, Compliance Hub still evaluates whether your HS Codes are correct, incorrect, or missing, but you apply any fixes manually via Health Check.

When Auto Mode is on, Compliance Hub automatically assigns and corrects HS Codes for newly synced products, and generates Custom Descriptions for products that don't already have one, using Swap AI. Manually entered descriptions always take precedence over generated ones, and you can override any AI-generated description at any time.

Run a Health Check before turning Auto Mode on. Enabling it means you're consenting to background automation of HS Code assignment and product data processing for your store.

Once your compliance data is synced to your store, it's mapped to products and variants by SKU and made available at the line-item level whenever an order is placed. That's what populates your commercial invoices — HS Code, Country of Origin, Unit Cost or declared value, MID Code, and Custom Description all flow through automatically.

Full end-to-end flow into commercial invoices currently requires an integration with the Swap Shipping API or similar. If your WMS doesn't have this, compliance data won't automatically flow through to your commercial invoice yet.

The last four digits of an HS Code are destination-specific — they depend on where an order is shipping to. Swap calculates and applies those automatically at checkout, so maintaining a 6-digit base code in your catalogue is all that's needed, and it avoids the risk of a mismatched 10-digit code causing customs issues in different markets. Be advised, this recommendation is only for users of Swap Global.

HS Codes, Country of Origin, and manufacturer details don't vary between the size, colour, or style options of the same product — they're the same across every variant. Managing them once at the product level is simpler and avoids inconsistent data across variants of the same item.