---
title: FilterValue - Storefront API
description: |
  A selectable option within a [`Filter`](/docs/api/storefront/2026-01/objects/Filter), such as a specific color, size, or product type. Each value includes a count of matching results and a human-readable label for display.

  The [`input`](/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.input) field provides ready-to-use JSON for building dynamic filtering interfaces. You can combine the `input` values from multiple selected [`FilterValue`](/docs/api/storefront/2026-01/objects/FilterValue) objects to construct filter queries. Visual representations are available through the [`image`](/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.image) or [`swatch`](/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.swatch) fields when the parent filter's presentation type supports them.
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/FilterValue
  md: https://shopify.dev/docs/api/storefront/latest/objects/FilterValue.md
---

# Filter​Value

object

Requires `unauthenticated_read_product_listings` access scope.

A selectable option within a [`Filter`](https://shopify.dev/docs/api/storefront/2026-01/objects/Filter), such as a specific color, size, or product type. Each value includes a count of matching results and a human-readable label for display.

The [`input`](https://shopify.dev/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.input) field provides ready-to-use JSON for building dynamic filtering interfaces. You can combine the `input` values from multiple selected [`FilterValue`](https://shopify.dev/docs/api/storefront/2026-01/objects/FilterValue) objects to construct filter queries. Visual representations are available through the [`image`](https://shopify.dev/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.image) or [`swatch`](https://shopify.dev/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.swatch) fields when the parent filter's presentation type supports them.

## Fields

* count

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

  non-null

  The number of results that match this filter value.

* id

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

  non-null

  A unique identifier.

* image

  [Media​Image](https://shopify.dev/docs/api/storefront/latest/objects/MediaImage)

  The visual representation when the filter's presentation is `IMAGE`.

* input

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

  non-null

  An input object that can be used to filter by this value on the parent field.

  The value is provided as a helper for building dynamic filtering UI. For example, if you have a list of selected `FilterValue` objects, you can combine their respective `input` values to use in a subsequent query.

* label

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

  non-null

  A human-friendly string for this filter value.

* swatch

  [Swatch](https://shopify.dev/docs/api/storefront/latest/objects/Swatch)

  The visual representation when the filter's presentation is `SWATCH`.

***

## Map

### Fields with this object

* [Filter.values](https://shopify.dev/docs/api/storefront/latest/objects/Filter#field-Filter.fields.values)