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

# decodeEncodedVariant

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

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

For an encoded option value string, decode into option value combinations. Entries represent a valid combination formatted as an array of option value positions.

### Parameters

* **encodedVariantField**

  **string**

  **required**

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

### Returns

* **DecodedOptionValues**

  Decoded option value combinations

### DecodedOptionValues

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

Examples

### Examples

* ####

  ##### 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/2026-04/utilities/isoptionvaluecombinationinencodedvariant)

***