> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# SwatchOptionValue

GraphQL object

A swatch option value - swatch values can be associated with a list of hexidecimal colors or an image.

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/storefront/types/objects/swatch-option-value

## Fields

- `hexColors` — List of up to 3 hex encoded colors to associate with a swatch value.
- `imageUrl` — Absolute path of a swatch texture image.
- `entityId` — Unique ID for the option value.
- `label` — Label for the option value.
- `isDefault` — Indicates whether this value is the chosen default selected value.
- `isSelected` — Indicates whether this value is selected based on sku/variantEntityId/optionValueIds overlay requested on the product node level.

## Definition

```graphql
type SwatchOptionValue implements CatalogProductOptionValue {
  hexColors: [String!]!
  imageUrl(width: Int!, height: Int, lossy: Boolean): String
  entityId: Int!
  label: String!
  isDefault: Boolean!
  isSelected: Boolean
}
```