---
title: OptionValue in Storefront API - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/optionvalue-in-storefront-api'
  md: 'https://shopify.dev/changelog/optionvalue-in-storefront-api.md'
metadata:
  effectiveApiVersion: 2024-07
  affectedApi:
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation Announcement
    handle: deprecation
  indicatesActionRequired: true
  createdAt: '2024-06-13T09:17:07-04:00'
  postedAt: '2024-06-17T09:11:00-04:00'
  updatedAt: '2024-06-13T09:31:04-04:00'
  effectiveAt: '2024-06-17T09:11:00-04:00'
---

June 17, 2024

Tags:

* Action Required
* Storefront GraphQL API
* 2024-07

# OptionValue in Storefront API

A new type called [`ProductOptionValue`](https://shopify.dev/docs/api/storefront/unstable/objects/ProductOptionValue) has been added to the new storefront API and is nested as a new field [`optionValues`](https://shopify.dev/docs/api/storefront/unstable/objects/ProductOption#field-productoption-optionvalues) on the [`ProductOption`](https://shopify.dev/docs/api/storefront/2024-07/objects/ProductOption) type.

As of 2024-07, you can use the `optionValues` field to fetch the option values associated with an option. This field deprecates the existing \[`values`] (<https://shopify.dev/docs/api/storefront/2024-04/objects/ProductOptionValue>) and provides richer option value information including swatches.