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

  Each value can include a visual swatch that displays a color or image. The [`firstSelectableVariant`](/docs/api/storefront/2025-04/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: 2025-04
api_name: storefront
type: object
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/storefront/2025-04/objects/productoptionvalue
  md: https://shopify.dev/docs/api/storefront/2025-04/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/2025-04/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/2025-04/objects/ProductVariant) objects.

Each value can include a visual swatch that displays a color or image. The [`firstSelectableVariant`](https://shopify.dev/docs/api/storefront/2025-04/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/2025-04/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/2025-04/scalars/ID)

  non-null

  A globally-unique ID.

* name

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

  non-null

  The name of the product option value.

* swatch

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

  The swatch of the product option value.

***

## Map

### Fields with this object

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

***

## Interfaces

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

  interface

***

## ProductOptionValue Implements

### Implements

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