---
title: >-
  Updated Country Harmonized System Code validations on Product Variant
  mutations - 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/updated-country-harmonized-system-code-validations-on-product-variant-mutations
  md: >-
    https://shopify.dev/changelog/updated-country-harmonized-system-code-validations-on-product-variant-mutations.md
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: false
  createdAt: '2025-02-06T17:03:38-05:00'
  postedAt: '2025-02-14T12:00:00-05:00'
  updatedAt: '2025-02-06T19:26:23-05:00'
  effectiveAt: '2025-02-07T12:00:00-05:00'
---

February 14, 2025

Tags:

* Admin GraphQL API
* 2025-04

# Updated Country Harmonized System Code validations on Product Variant mutations

Starting with the Admin GraphQL API version 2025-04, all Product Variant mutations will include validations to ensure that any country-specific harmonized system codes provided in the input are compatible with the existing codes on the Inventory Item. These country-specific codes must be prefixed with the item's global harmonized system code and must be at least six characters long. If the input country HS codes do not meet these criteria, a user error will be returned, specifying the invalid input index and providing an error message.

The following Admin GraphQL API Product Variant mutations will incorporate these validations starting from API version 2025-04:

* ProductVariantsBulkCreate
* ProductVariantsBulkUpdate
* ProductVariantCreate
* ProductVariantUpdate
* ProductSet