---
title: >-
  Introducing PRODUCT_CATEGORY_ID in CollectionRuleColumn and Deprecating
  PRODUCT_TAXONOMY_NODE_ID for automated collection creation - 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/introducing-product_category_id-in-collectionrulecolumn-and-deprecating-product_taxonomy_node_id-for-automated-collection-creation
  md: >-
    https://shopify.dev/changelog/introducing-product_category_id-in-collectionrulecolumn-and-deprecating-product_taxonomy_node_id-for-automated-collection-creation.md
metadata:
  effectiveApiVersion: 2024-10
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Admin REST API
      handle: admin-rest
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2024-09-11T18:18:42-04:00'
  postedAt: '2024-09-11T18:10:00-04:00'
  updatedAt: '2024-09-11T19:17:17-04:00'
  effectiveAt: '2024-09-11T18:10:00-04:00'
---

September 11, 2024

Tags:

* Action Required
* Admin GraphQL API
* Admin REST API
* 2024-10

# Introducing PRODUCT\_CATEGORY\_ID in CollectionRuleColumn and Deprecating PRODUCT\_TAXONOMY\_NODE\_ID for automated collection creation

As of API version 2024-10, we're adding the new **PRODUCT\_CATEGORY\_ID** as a column for the `CollectionRuleColumn` which is [used to create automated collections](https://shopify.dev/docs/api/admin-graphql/unstable/enums/CollectionRuleColumn). This field maps directly to the newly added Product Category as defined in the [updated standard product taxonomy](https://github.com/Shopify/product-taxonomy/tree/main) and will allow for the creation of smart collections based on this new category tree.

### What's new?

* **Introduction of `PRODUCT_CATEGORY_ID` Column**: We are introducing a new column, `PRODUCT_CATEGORY_ID`, in the `CollectionRuleColumn`. This column will directly map to the category ID of a product, allowing for more precise and efficient collection rule creation based on product categories as defined in the [updated standard product taxonomy](https://github.com/Shopify/product-taxonomy/tree/main).

### What's deprecated?

* **Deprecation of `PRODUCT_TAXONOMY_NODE_ID` Column**: The `PRODUCT_TAXONOMY_NODE_ID` column is being deprecated. This column previously used the now-deprecated `productCategory` field on products, the previous method for categorising products before the [updated standard product taxonomy](https://github.com/Shopify/product-taxonomy/tree/main) was introduced this year. Developers should transition to using the new `PRODUCT_CATEGORY_ID` column to ensure newly created products that necessarily use the updated product taxonomy are included in automated collections as expected.

### Developer action required

Developers are encouraged to update their implementations to use the new `PRODUCT_CATEGORY_ID` column when specifying product attributes for populating smart collections. The deprecated `PRODUCT_TAXONOMY_NODE_ID` will remain functional but is scheduled for removal in a future API version. Transitioning early will ensure smoother operations and access to the enhanced functionality provided by the new schema.

### Example of updated usage

To create a smart collection using the new `PRODUCT_CATEGORY_ID`, modify the collection creation mutation as follows:

```graphql
mutation CollectionCreate($input: CollectionInput!) {
  collectionCreate(input: $input) {
    userErrors {
      field
      message
    }
    collection {
      id
      title
      descriptionHtml
      handle
      sortOrder
      ruleSet {
        appliedDisjunctively
        rules {
          column
          relation
          condition
        }
      }
    }
  }
}
{
  "input": {
    "title": "Our entire shoe collection",
    "descriptionHtml": "View <b>every</b> shoe available in our store.",
    "ruleSet": {
      "appliedDisjunctively": false,
      "rules": {
        "column": "PRODUCT_CATEGORY_ID",
        "relation": "EQUALS",
        "condition": "gid://shopify/TaxonomyCategory/aa-5" 
      }
    }
  }
}

Learn more about collection creation at [Shopify.dev](https://shopify.dev/docs/api/admin-graphql/latest/mutations/collectionCreate)
```