---
title: >-
  Filter products by category or taxonomy metafield - 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/filter-products-by-category-or-taxonomy-metafield
  md: >-
    https://shopify.dev/changelog/filter-products-by-category-or-taxonomy-metafield.md
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2024-11-13T15:58:09-05:00'
  postedAt: '2025-01-01T15:57:00-05:00'
  updatedAt: '2024-11-22T14:22:44-05:00'
  effectiveAt: '2025-01-01T15:57:00-05:00'
---

January 1, 2025

Tags:

* Storefront GraphQL API
* 2025-01

# Filter products by category or taxonomy metafield

Starting with Storefront API version 2025-01, you can now filter products within collections and search results using `CategoryFilter` and `TaxonomyMetafieldFilter`.

* **`CategoryFilter`**: Filter products by a category ID.
* **`TaxonomyMetafieldFilter`**: Filter products based on a taxonomy metafield namespace, key, and value.

Learn more about [filtering products in collections](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/filter-products) on Shopify.dev.