Global HS code is now supported in GraphQL Admin API

As of 2025-10, The countryCode field in CountryHarmonizedSystemCodeInput is now nullable. When set to null, the HS code (harmonized system code) entry represents a global HS code rather than a country-specific one.

Why this matters Many merchants work with global HS codes (typically 6-digit codes) that apply universally across countries before being extended with country-specific digits. This enhancement allows you to:

• Store global HS codes without requiring a specific country context
• Reduce redundancy when the same base HS code applies across multiple countries
• Better align with international trade practices where global codes serve as the foundation

Migration No action required. This is a non-breaking change:

• Existing implementations that provide countryCode will continue to work unchanged
• You can now optionally pass null for countryCode to create global HS code entries

Related resources

• [Add HS codes and the country or region of origin to your products]https://help.shopify.com/en/manual/international/duties-and-import-taxes/charging-duties#add-hs-codes)
• International Trade Documentation