> 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.

# Product Options

## Product Options

> **Note**
>
> This is archived documentation. The V2 Catalog API is deprecated. For current API documentation, see the [Catalog API](/developer/docs/admin/catalog-and-inventory).

#### Product Options Object Properties

| Title          | Name      | Type | Description |
| -------------- | --------- | ---- | ----------- |
| `id`           | `int`     |      |             |
| `option_id`    | `int`     |      |             |
| `display_name` | `string`  |      |             |
| `sort_order`   | `int`     |      |             |
| `is_required`  | `boolean` |      |             |

Swatch (`CS`) options don't support a default value. The `is_default` property on [option values](/developer/docs/archive/store-operations/v2-catalog-products/v2-option-values) is not supported for swatch options.

#### List Product Options

Gets the options associated with a product.

`GET /stores/{store_hash}/v2/products/{product_id}/options`

### Pagination

Parameters can be added to the URL query string to paginate the collection. The maximum limit is 250. If a limit isn't provided, up to 50 product\_options are returned by default.

| Parameter | Type | Example                                               |
| --------- | ---- | ----------------------------------------------------- |
| `page`    | int  | `/api/v2/products/{product_id}/options?page={number}` |
| `limit`   | int  | `/api/v2/products/{product_id}/options?limit={count}` |

### Response

Example JSON returned in the response:

```json showLineNumbers={false}
[
  {
    "id": 13,
    "option_id": 8,
    "display_name": "iPod Capacities",
    "sort_order": 0,
    "is_required": true
  },
  {
    "id": 14,
    "option_id": 9,
    "display_name": "Accessories",
    "sort_order": 1,
    "is_required": false
  }
]
```

#### Get a Product Option

Gets an option associated with a product.

`GET /stores/{store_hash}/v2/products/{product_id}/options/{id}`

### Response

Example JSON returned in the response:

```json showLineNumbers={false}
{
  "id": 14,
  "option_id": 9,
  "display_name": "Accessories",
  "sort_order": 1,
  "is_required": false
}
```