---
title: FilterValue - Storefront API
description: A selectable value within a filter.
api_version: 2025-10
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 value within a filter.

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