When shipping your products internationally, some carrier services require some additional information so that these products can make it through customs with no issues. The information that is required is listed below.


Required Commodity Information

  • Commodity Composition 
  • Country of Manufacturer  
  • Commodity Description  


It is possible to download this additional commodity data to Shiptheory from Shopify when Shiptheory picks up your orders. This is done by creating custom fields within Shopify known as metafields. Your products Commodity Code is already setup within Shopify but the rest of these custom fields have not, you can use any of the metadata editors within the Shopify app store to create these metafields but for this support document i'll be using Metafields Editor by Webify Technology since it's free for anyone to install and use.


A metafield is made up of 3 sections, a 'namespace', a 'key' and a 'value' i'll explain below what these mean and how they would be used using an analogy.


Let's assume you're setting up your commodity metafields for your products:

Namespace - The namespace differentiates metadata from one another and in this case you would call your namespace for this metadata, 'Commodity Information'. A general description that's going to contain more in-depth information within it.

Key - A key is the name of the metafield, using the previous example of the Namespace being 'Commodity Information', your key would be 'Commodity Description' and 'Country Of Manufacture'

Value - As you'd expect, this is the value of the key, for the key 'Commodity description' it would have a value like 'trousers', 'shirt' or 'notepad'.


I've included a visual representation of how these values work with each other to give you a better idea of how it actually functions. This also showcases why it's important to be consistent, if you tell Shiptheory that all your Commodity Descriptions are in the 'Commodity Description' key and then you go and create one in a new key called 'customs', we won't look in that new customs key because we weren't told to look there.




It's extremely important when setting up metadata that you remain consistent, all of your commodity information should all be set to the same namespace, 'Commodity Information' in my case. All of your Commodity descriptions would have to be assigned to the Commodity description key. This is because we will look at the exact namespace and keys you set within Shopify and nowhere else.


Below is the Shopify metafield within Shiptheory all filled in using the example above, you can find these by clicking on the little cog in the bottom left hand corner your Shopify settings screen.


Please note that if you use product variants you must set the metafields at the variant level as well


If you have any queries about this integration our support team would be happy to help you out.