---
title: Filter - Storefront API
description: >
  A filter option available on collection and search results pages. Each filter
  includes a type, display label, and selectable values that customers can use
  to narrow down products.


  The [`FilterValue`](/docs/api/storefront/2025-07/objects/FilterValue) objects
  contain an
  [`input`](/docs/api/storefront/2025-07/objects/FilterValue#field-FilterValue.fields.input)
  field that you can combine to [build dynamic filtering
  queries](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/filter-products).
  Merchants [configure available
  filters](https://help.shopify.com/manual/online-store/search-and-discovery/filters)
  using the Shopify Search & Discovery app.
api_version: 2025-07
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/2025-07/objects/Filter'
  md: 'https://shopify.dev/docs/api/storefront/2025-07/objects/Filter.md'
---

# Filter

object

Requires `unauthenticated_read_product_listings` access scope.

A filter option available on collection and search results pages. Each filter includes a type, display label, and selectable values that customers can use to narrow down products.

The [`FilterValue`](https://shopify.dev/docs/api/storefront/2025-07/objects/FilterValue) objects contain an [`input`](https://shopify.dev/docs/api/storefront/2025-07/objects/FilterValue#field-FilterValue.fields.input) field that you can combine to [build dynamic filtering queries](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/products-collections/filter-products). Merchants [configure available filters](https://help.shopify.com/manual/online-store/search-and-discovery/filters) using the Shopify Search & Discovery app.

## Fields

* id

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

  non-null

  A unique identifier.

* label

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

  non-null

  A human-friendly string for this filter.

* presentation

  [Filter​Presentation](https://shopify.dev/docs/api/storefront/2025-07/enums/FilterPresentation)

  Describes how to present the filter values. Returns a value only for filters of type `LIST`. Returns null for other types.

* type

  [Filter​Type!](https://shopify.dev/docs/api/storefront/2025-07/enums/FilterType)

  non-null

  An enumeration that denotes the type of data this filter represents.

* values

  [\[Filter​Value!\]!](https://shopify.dev/docs/api/storefront/2025-07/objects/FilterValue)

  non-null

  The list of values for this filter.

***

## Map

### Connections with this object

* [ProductConnection.filters](https://shopify.dev/docs/api/storefront/2025-07/connections/ProductConnection#returns-filters)
* [SearchResultItemConnection.productFilters](https://shopify.dev/docs/api/storefront/2025-07/connections/SearchResultItemConnection#returns-productFilters)