---
title: Swatch - Storefront API
description: >
  A visual representation for filter values, containing a color, an image, or
  both. The [`FilterValue`](/docs/api/storefront/2026-01/objects/FilterValue)
  object's
  [`swatch`](/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.swatch)
  field returns this when the filter's presentation is set to `SWATCH`.
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/Swatch'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/Swatch.md'
---

# Swatch

object

A visual representation for filter values, containing a color, an image, or both. The [`FilterValue`](https://shopify.dev/docs/api/storefront/2026-01/objects/FilterValue) object's [`swatch`](https://shopify.dev/docs/api/storefront/2026-01/objects/FilterValue#field-FilterValue.fields.swatch) field returns this when the filter's presentation is set to `SWATCH`.

## Fields

* color

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

  The swatch color.

* image

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

  The swatch image.

***

## Map

### Fields with this object

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