# Option values

> An Option Value is one possible value of an option, such as Medium for a Size option.

An **Option Value** is one possible value of a [Product Option](/api/product-management/options/) - for example *Medium* for a *Size* option, or *Red* for a *Color* option. Option values are ordered by `position` within their option, and their combinations across a product's options define its [Variants](/api/product-management/variants/).

The `value` field is translatable, so the same value can read *Medium* in one locale and *Moyen* in another.

## The Option Value object

## Endpoints

Unlike options and variants, option values are created through a single top-level endpoint and read through their parent option:

- **Create** - [`POST /option_values`](/api/product-management/option-values/create/), passing the `productOption` IRI the value belongs to.
- **List, retrieve, update, delete** - nested under `/product_options/{productOptionId}/option_values`.

## Common workflows

- **Populate an option.** After creating a *Size* option, add *S*, *M* and *L* with three [`POST /option_values`](/api/product-management/option-values/create/) calls, each pointing at the same `productOption`.
- **Reorder values.** [`PATCH`](/api/product-management/option-values/update/) the `position` to change the display order within the option.
- **Localize a value.** Send `X-Flowkiwi-Locale` on write to set the `value` for that locale.