Developer changelog

Subscribe to the changelog to stay up to date on recent changes to Shopify’s APIs and other developer products, as well as preview upcoming features and beta releases.

Get updates by RSS

Taxonomy API


Action required

Shopify has introduced a public product taxonomy, serving as an open-source, standardized, and global classification of products sold on Shopify. This taxonomy, composed of product categories, attributes, and attribute values, is utilized across Shopify and integrated with numerous marketplaces. You can view the latest product taxonomy on our taxonomy explorer.

The new product taxonomy is now available in our public API with the 2024-04 release. This feature allows developers to navigate the taxonomy tree for categories, attributes, and values.

In order to support this change a number two existing APIs have been deprecated and replaced in favor of queryRoot.taxonomy.categories

  • queryRoot.productTaxonomy
  • queryRoot.productTaxonomyNodes

Additionally the following changes have been made:

  • The ProductTaxonomyNode type has been replaced with a TaxonomyCategory type.
  • The productCategory field on Product has been deprecated and replaced by category. This field directly references the new TaxonomyCategory type.