---
title: decodeEncodedVariant
description: >-
  Decodes an encoded option value string into an array of option value
  combinations.
api_version: 2025-07
api_name: hydrogen
source_url:
  html: 'https://shopify.dev/docs/api/hydrogen/latest/utilities/decodeencodedvariant'
  md: >-
    https://shopify.dev/docs/api/hydrogen/latest/utilities/decodeencodedvariant.md
---

# decode​Encoded​Variant

Decodes an encoded option value string into an array of option value combinations.

## decode​Encoded​Variant([encodedVariantField](#props-propertydetail-encodedvariantfield)​)

### Parameters

* encodedVariantField

  string

  required

  Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](https://shopify.dev/docs/api/storefront/2025-07/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](https://shopify.dev/docs/api/storefront/2025-07/objects/Product#field-encodedvariantavailability)

### Returns

* DecodedOptionValues

  Decoded option value combinations

  ### DecodedOptionValues

  * number[][]

### DecodedOptionValues

```ts
number[][]
```

Examples

### Examples

* #### Example code

  ##### Description

  Decode an encoded option value string

  ##### JavaScript

  ```js
  import {decodeEncodedVariant} from '@shopify/hydrogen';

  // product.options = [
  //   {
  //     name: 'Color',
  //     optionValues: [
  //       {name: 'Red'},
  //       {name: 'Blue'},
  //       {name: 'Green'},
  //     ]
  //   },
  //   {
  //     name: 'Size',
  //     optionValues: [
  //       {name: 'S'},
  //       {name: 'M'},
  //       {name: 'L'},
  //     ]
  //   }
  // ]

  const encodedVariantAvailability = 'v1_0:0-2,1:2,';

  const decodedVariantAvailability = decodeEncodedVariant(
    encodedVariantAvailability,
  );

  // decodedVariantAvailability
  // {
  //   [0,0],    // Red, S
  //   [0,1],    // Red, M
  //   [0,2],    // Red, L
  //   [1,2]     // Blue, L
  // }
  ```

## Related

[- isOptionValueCombinationInEncodedVariant](https://shopify.dev/docs/api/hydrogen//utilities/isOptionValueCombinationInEncodedVariant)