---
title: SelectedOption - Storefront API
description: >
  A name/value pair representing a product option selection on a variant. The
  [`ProductVariant`](/docs/api/storefront/2026-01/objects/ProductVariant)
  object's
  [`selectedOptions`](/docs/api/storefront/2026-01/objects/ProductVariant#field-ProductVariant.fields.selectedOptions)
  field returns this to indicate which options define that variant, such as
  "Size: Large" or "Color: Red".
api_version: 2026-01
api_name: storefront
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/storefront/latest/objects/SelectedOption'
  md: 'https://shopify.dev/docs/api/storefront/latest/objects/SelectedOption.md'
---

# Selected​Option

object

Requires `unauthenticated_read_product_listings` access scope.

A name/value pair representing a product option selection on a variant. The [`ProductVariant`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant) object's [`selectedOptions`](https://shopify.dev/docs/api/storefront/2026-01/objects/ProductVariant#field-ProductVariant.fields.selectedOptions) field returns this to indicate which options define that variant, such as "Size: Large" or "Color: Red".

## Fields

* name

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

  non-null

  The product option’s name.

* value

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

  non-null

  The product option’s value.

***

## Map

### Fields with this object

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