---
title: Taxonomy 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/taxonomy-api
  md: https://shopify.dev/changelog/taxonomy-api.md
---

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

April 1, 2024

Tags:

* Action Required
* Admin GraphQL API
* 2024-04

# Taxonomy API

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](https://shopify.github.io/product-taxonomy/releases/unstable/?categoryId=gid%3A%2F%2Fshopify%2FTaxonomy%2FCategory%2Fsg-4-17-2-17).

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`](https://shopify.dev/docs/api/admin-graphql/2024-04/objects/Taxonomy#connection-categories)

* `queryRoot.productTaxonomy`
* `queryRoot.productTaxonomyNodes`

Additionally the following changes have been made:

* The `ProductTaxonomyNode` type has been replaced with a [`TaxonomyCategory`](https://shopify.dev/docs/api/admin-graphql/2024-04/objects/TaxonomyCategory) type.
* The `productCategory` field on `Product` has been deprecated and replaced by [`category`](https://shopify.dev/docs/api/admin-graphql/2024-04/objects/Product#field-product-category). This field directly references the new `TaxonomyCategory` type.