---
title: ProductOptionValue - Storefront API
description: >
  A specific value for a
  [`ProductOption`](/docs/api/storefront/2026-01/objects/ProductOption), such as
  "Red" or "Blue" for a "Color" option. Option values combine across different
  options to create
  [`ProductVariant`](/docs/api/storefront/2026-01/objects/ProductVariant)
  objects.


  Each value can include a visual swatch that displays a color or image. The
  [`firstSelectableVariant`](/docs/api/storefront/2026-01/objects/ProductOptionValue#field-ProductOptionValue.fields.firstSelectableVariant)
  field returns the variant that combines this option value with the
  lowest-position values for all other options. This is useful for building
  product selection interfaces.


  Learn more about [Shopify's product
  model](https://shopify.dev/docs/apps/build/product-merchandising/products-and-collections).
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/ProductOptionValue'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/ProductOptionValue.md'
---

# Product​Option​Value

object

Requires `unauthenticated_read_product_listings` access scope.

A specific value for a [`ProductOption`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductOption), such as "Red" or "Blue" for a "Color" option. Option values combine across different options to create [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant) objects.

Each value can include a visual swatch that displays a color or image. The [`firstSelectableVariant`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductOptionValue#field-ProductOptionValue.fields.firstSelectableVariant) field returns the variant that combines this option value with the lowest-position values for all other options. This is useful for building product selection interfaces.

Learn more about [Shopify's product model](https://shopify.dev/docs/apps/build/product-merchandising/products-and-collections).

## Fields

* first​Selectable​Variant

  [Product​Variant](https://shopify.dev/docs/api/storefront/latest/objects/ProductVariant)

  The product variant that combines this option value with the lowest-position option values for all other options.

  This field will always return a variant, provided a variant including this option value exists.

* id

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

  non-null

  A globally-unique ID.

* name

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

  non-null

  The name of the product option value.

* swatch

  [Product​Option​Value​Swatch](https://shopify.dev/docs/api/storefront/latest/objects/ProductOptionValueSwatch)

  The swatch of the product option value.

***

## Map

### Fields with this object

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

***

## Interfaces

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

  interface

***

## ProductOptionValue Implements

### Implements

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