---
title: FilterValue - Storefront API
description: >
  A selectable option within a
  [`Filter`](/docs/api/storefront/unstable/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/unstable/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/unstable/objects/FilterValue) objects to
  construct filter queries. Visual representations are available through the
  [`image`](/docs/api/storefront/unstable/objects/FilterValue#field-FilterValue.fields.image)
  or
  [`swatch`](/docs/api/storefront/unstable/objects/FilterValue#field-FilterValue.fields.swatch)
  fields when the parent filter's presentation type supports them.
api_version: unstable
api_name: storefront
source_url:
  html: 'https://shopify.dev/docs/api/storefront/unstable/objects/FilterValue'
  md: 'https://shopify.dev/docs/api/storefront/unstable/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/unstable/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/unstable/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/unstable/objects/FilterValue) objects to construct filter queries. Visual representations are available through the [`image`](https://shopify.dev/docs/api/storefront/unstable/objects/FilterValue#field-FilterValue.fields.image) or [`swatch`](https://shopify.dev/docs/api/storefront/unstable/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/unstable/scalars/Int)

  non-null

  The number of results that match this filter value.

* id

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

  non-null

  A unique identifier.

* image

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

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

* input

  [JSON!](https://shopify.dev/docs/api/storefront/unstable/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/unstable/scalars/String)

  non-null

  A human-friendly string for this filter value.

* swatch

  [Swatch](https://shopify.dev/docs/api/storefront/unstable/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/unstable/objects/Filter#field-Filter.fields.values)