---
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/posts/country-hs-codes-global-value'
  md: 'https://shopify.dev/changelog/posts/country-hs-codes-global-value.md'
metadata:
  effectiveApiVersion: 2025-10
  affectedApi:
    - displayName: GraphQL Admin API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-08-22T11:01:37-04:00'
  postedAt: '2025-09-01T12:00:00-04:00'
  updatedAt: '2025-08-26T17:41:52-04:00'
  effectiveAt: '2025-09-01T12:00:00-04:00'
---

September 1, 2025

# Global HS code is now supported in GraphQL Admin API

DateSeptember 1, 2025

Version[2025-10](https://shopify.dev/changelog?api_version=2025-10)

FlagsNew

SurfacesAPI

Affected APIs[GraphQL Admin API](https://shopify.dev/changelog?api_type=admin-graphql)

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)