---
title: ProductOptionValueSwatch - Storefront API
description: |
  A visual representation for a [`ProductOptionValue`](/docs/api/storefront/2026-01/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-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/latest/objects/productoptionvalueswatch
  md: https://shopify.dev/docs/api/storefront/latest/objects/productoptionvalueswatch.md
---

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