Starting October 2025, Shopify has introduced support for global HS codes in the GraphQL Admin API. This enhancement provides merchants with greater flexibility when managing harmonized system (HS) codes for their products.
What’s New?
The countryCode field in CountryHarmonizedSystemCodeInput is now nullable. This means that when the field is set to null, the HS code represents a global HS code rather than a country-specific one.
Why This Matters
This update simplifies how merchants handle HS codes, especially those who deal with international trade. Key advantages include:
- Store global HS codes without the need for a specific country context.
- Reduce redundancy when the same base HS code applies to multiple countries.
- Align with international trade practices where global HS codes serve as a foundational standard before country-specific extensions.
Benefits for Merchants
Merchants can now:
- Streamline the management of product classifications across different regions.
- Ensure compatibility with global trade standards.
- Avoid complexities in maintaining separate HS code entries for each country.
Migration Details
No action is required for existing implementations. This is a non-breaking change:
- Configurations that provide a specific
countryCodewill continue to function as before. - For new entries, you can pass
nullfor thecountryCodeto define global HS code entries.
Related Resources
For further details about using HS codes and their applications in Shopify, visit our documentation: Add HS Codes and the Country or Region of Origin to Your Products.