---
title: ProductOptionValueSwatch - Storefront API
description: >-
  A visual representation for a
  [`ProductOptionValue`](/docs/api/storefront/2026-10/objects/ProductOptionValue),

  such as a color or image. Swatches help customers visualize options like "Red"

  or "Blue" without relying solely on text labels.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/objects/ProductOptionValueSwatch
  md: >-
    https://shopify.dev/docs/api/storefront/latest/objects/ProductOptionValueSwatch.md
api_name: storefront
api_type: graphql
type: object
---

# Product​Option​Value​Swatch

object

Requires `unauthenticated_read_product_listings` access scope.

A visual representation for a [`ProductOptionValue`](https://shopify.dev/docs/api/storefront/2026-10/objects/ProductOptionValue), such as a color or image. Swatches help customers visualize options like "Red" or "Blue" without relying solely on text labels.

## Fields

* color

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

  The swatch color.

* image

  [Media](https://shopify.dev/docs/api/storefront/latest/interfaces/Media)

  The swatch image.

***

## Map

### Fields with this object

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