---
title: TaxonomyMetafieldFilter - Storefront API
description: |
  A filter used to view a subset of products in a collection matching a specific taxonomy metafield value.
api_version: 2025-10
api_name: storefront
type: input-object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/input-objects/taxonomymetafieldfilter
  md: https://shopify.dev/docs/api/storefront/latest/input-objects/taxonomymetafieldfilter.md
---

# Taxonomy​Metafield​Filter

input\_object

A filter used to view a subset of products in a collection matching a specific taxonomy metafield value.

## Fields

* key

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  The key of the metafield to filter on.

* namespace

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  The namespace of the metafield to filter on.

* value

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  The value of the metafield.

***

## Input objects using this input

* [Product​Filter.taxonomyMetafield](https://shopify.dev/docs/api/storefront/latest/input-objects/ProductFilter#fields-taxonomyMetafield)

  INPUT OBJECT

  The input fields for a filter used to view a subset of products in a collection. By default, the `available` and `price` filters are enabled. Filters are customized with the Shopify Search & Discovery app. Learn more about [customizing storefront filtering](https://help.shopify.com/manual/online-store/themes/customizing-themes/storefront-filters).

***

## Map

### Input objects using this input

* [Product​Filter.taxonomyMetafield](https://shopify.dev/docs/api/storefront/latest/input-objects/ProductFilter#fields-taxonomyMetafield)