---
title: MetafieldFilter - Storefront API
description: |
  A filter used to view a subset of products in a collection matching a specific metafield value.

  Only the following metafield types are currently supported:
  - `number_integer`
  - `number_decimal`
  - `single_line_text_field`
  - `boolean` as of 2022-04.
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/MetafieldFilter
  md: https://shopify.dev/docs/api/storefront/latest/input-objects/MetafieldFilter.md
---

# Metafield​Filter

input\_object

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

Only the following metafield types are currently supported:

* `number_integer`
* `number_decimal`
* `single_line_text_field`
* `boolean` as of 2022-04.

## 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.productMetafield](https://shopify.dev/docs/api/storefront/latest/input-objects/ProductFilter#fields-productMetafield)

  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).

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

  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.productMetafield](https://shopify.dev/docs/api/storefront/latest/input-objects/ProductFilter#fields-productMetafield)
* [Product​Filter.variantMetafield](https://shopify.dev/docs/api/storefront/latest/input-objects/ProductFilter#fields-variantMetafield)