---
title: Global HS code is now supported  in GraphQL Admin API - Shopify developer changelog
description: Shopify’s developer changelog documents all changes to Shopify’s platform. Find the latest news and learn about new platform opportunities.
source_url:
  html: https://shopify.dev/changelog/country-hs-codes-global-value
  md: https://shopify.dev/changelog/country-hs-codes-global-value.md
---

[Back to Developer changelog](https://shopify.dev/changelog)

September 1, 2025

Tags:

* Admin GraphQL API
* 2025-10

# Global HS code is now supported in GraphQL Admin API

As of `2025-10`, The `countryCode` field in [`CountryHarmonizedSystemCodeInput`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/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](https://www.wcoomd.org/en/topics/nomenclature/overview/what-is-the-harmonized-system.aspx)