Customs documentation for international shipments

An international shipment that crosses a customs border is declared to the customs authority in the destination country. When you create a label for one in Shopify, that declaration is built from the details on your products and your order.

Missing or inaccurate customs details can hold a shipment at the border, add unexpected duties, or prevent the label from being created at all.

Required customs details

Before you can create a label for a shipment that needs a customs declaration, each item in the shipment needs the following details:

  • A Harmonized System (HS) code of at least 6 digits. Learn more about adding HS codes to your products.
  • A country or region of origin, which is where the item was manufactured.
  • A description of the goods.
  • The quantity of the item.
  • The value of the item.
  • An item weight.

You can add HS codes and countries of origin on a product's page, during label purchase, with the bulk editor, or with an inventory CSV file. Details that you save to a product are reused on every international label for that product.

Considerations for customs documentation

Before you ship internationally, review the following considerations:

  • A custom item that you add directly to an order has no product page, so you enter its HS code during label purchase.
  • United States military and diplomatic addresses are treated as international, so shipments to an Army Post Office (APO), Fleet Post Office (FPO), or Diplomatic Post Office (DPO) address need customs details.
  • If you use Managed Markets, then HS codes are assigned to your products for you and can't be edited.
  • If you sell regulated consumer products into the United States, then your shipments might also need CPSC eFiling data to clear customs.

Goods descriptions on customs declarations

The description on your customs declaration usually comes from the item's HS code rather than from your product title. Each HS code carries a standardized description that customs authorities recognize, so the description can be longer or more technical than the name that your customers know. If no standardized description is available for the code, then the product or item name is used instead.

You can edit the description in the Edit customs information section during label purchase. An edited description applies to that label only, and isn't saved to the product for later shipments.

Some carriers shorten a long description to fit the character limits of their own systems, which is expected.

A custom item has no product page to draw from, so its description matches the item name that you entered on the order.

Customs forms and commercial invoices

An international shipment can need two kinds of paperwork:

Several carriers submit customs documentation electronically for destinations that support it, which leaves you with only the shipping label to print. To learn which destinations qualify for your carrier, refer to DHL Express, DHL Express in Canada, or UPS.

If a driver asks for a paper commercial invoice for a shipment whose documentation was submitted electronically, then tell them that the invoice was sent to the carrier with the label. If the driver still needs a paper copy, then you can create one with your carrier's own invoice tool.

Troubleshooting customs information

If a customs declaration prevents you from creating a label, then review the following common issues and solutions.

Add item weight to customs declaration to see shipping services

If this message is displayed when you create an international label, then an item in the order has no weight.

  1. In the Items section, click Edit customs information.
  2. Add a weight for each item.
  3. Add any missing HS code and country or region of origin.
  4. Click Save.

Shipping services are displayed after every item in the order has a weight, an HS code, and a country or region of origin.

Troubleshoot a missing HS code or country of origin at label purchase

When a shipment needs a customs declaration, you can't create its label until every item has an HS code and a country or region of origin. Add them in the Edit customs information section, and then select Save shipping info to product details so that the same items don't need them again on your next shipment.

For where to find the codes that apply to your products, refer to adding HS codes to your products.

Troubleshoot an HS code that loses its decimal points

You can enter a code that's longer than 6 digits, such as a 10-digit code. The decimal points are removed when the code is stored, so 1234.56.78.90 is stored as 1234567890. This is expected, and the digits are kept in the order that you entered them.

If you edited the item weights on a customs form and you still can't create the label, then refer to troubleshooting shipping labels.