Add a customs declaration to an international shipping label
Set HS codes and countries of origin, save customs defaults, and buy cross-border Shippo labels that carry a customs declaration built from the order.
On this page
Customs declarations are built for labels bought with the Shippo Shipping Labels app (see connect-shipping-apps-and-labels). Your ship-from location needs a full address with a country. Domestic labels are unchanged and show no customs section.
Know when customs applies
The Customs declaration section appears on the order's Shipping label card only when the destination country differs from the country of the Ship from location. Shipments between two EU member countries, and between the US and its territories (PR, VI, GU, AS, MP), are treated as domestic and skip customs.
Give each item an HS code and origin
Open the variant (Products > a product > a variant) and fill in HS code and Country/region of origin in its Shipping card; leave them blank to use the product's own values. The bulk editor has the same two columns for many variants at once. See set-variant-shipping-and-customs.
Save customs defaults (optional)
Go to Settings > Shipping and delivery and find the Customs defaults card. Fill in what you want to reuse, then select Save customs defaults ("Customs defaults updated").
- Default HS code and Default country of origin: used only for items that have none of their own, and only when you tick the box on a label.
- Contents type: Merchandise, Gift, Commercial sample, Documents, Returned goods or Other.
- If it can't be delivered: Return to sender or Abandon.
- Signer (store's legal name): certifies the declaration; if blank your store name is used.
- Duties and taxes: Recipient pays on arrival (DDU) or I pay in advance (DDP).
- Minimum item value: what is declared for free or gift items priced 0.00 (default 1.00). Enter 0 to block labels that contain such an item.
Open the Shipping label card on the order
Open the order. On the Shipping label card choose the Ship from location, the Package and the Total weight, and tick the items to ship. When the parcel crosses a border, a Customs declaration block appears: "This parcel crosses a border. Customs needs an HS code and country of origin for every item."
Complete the declaration
Fill in the block; the fields start from your Customs defaults.
- Contents, If it can't be delivered, and (when Contents is Other) Describe the contents.
- Signed by (legal name).
- For each item: HS code (6 to 10 digits, dots allowed) and Origin (two letters). They are filled from the variant or product when set.
- Duties and taxes: Recipient pays on arrival (DDU) or I pay in advance (DDP).
- ITN: only for shipments from the US with a declared value of USD 2,500 or more; enter the AES ITN (X followed by 14 digits).
- Use store defaults for items with no HS code or origin: tick this to fill gaps from your Customs defaults. It is never applied silently.
Fix anything it flags
Get rates stays disabled until every item has an HS code and origin, and a message names the item or the problem (for example "Describe the contents of the parcel"). Fix it on the card, or set the missing values once in Settings > Shipping and delivery > Customs defaults and tick Use store defaults.
Get rates and buy the label
Select Get rates, choose a rate and select Buy label. Changing anything in the declaration or the items after getting rates means you must select Get rates again, so the label always prices what you see.
Check what was sent
Your store builds the declaration from the order itself: each item's description is the product title, with its quantity, net weight, declared value (the order price times quantity, or your Minimum item value for a 0.00 item), HS code and country of origin. You can only choose the contents type, non-delivery option, explanation, signer, duties and taxes, ITN and HS/origin overrides. After purchase the label shows "Customs: Gift, 2 items, signed by …" and a Commercial invoice link when Shippo returns one.
CHECK YOUR WORK
You’re ready when…
- Every item has an HS code and origin, or you ticked Use store defaults.
- The Ship from location has a country and full address.
- You set the Signer to your legal name if it differs from your store name.
- You re-ran Get rates after changing the declaration.
IF SOMETHING DOESN’T LOOK RIGHT
Troubleshooting
The Customs declaration section does not show.
The destination country is the same as the country of the Ship from location, or the pair is treated as domestic (EU to EU, or the US and its territories). Check the Ship from location's country in Settings > Locations.
Get rates is disabled and a message names an item.
That item has no HS code or country of origin. Fill them in on the card, on the variant, or tick Use store defaults after saving Customs defaults.
The label says an item has a price of 0.00.
Customs needs a value for every item. Set a Minimum item value in Customs defaults (default 1.00) so free or gift items are declared at that amount per unit; 0 blocks the label instead.
A US shipment asks for an ITN.
US exports declared at USD 2,500 or more need an AES ITN. Enter it in the ITN field; below that amount no ITN is needed.
Does this work for ShipStation labels?
No. Customs declarations are only built for Shippo labels; ShipStation labels and exports do not carry the HS code or origin, so enter customs details in ShipStation.