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

# Select

Allows you to display select controls for your widget.

---

**Widget Configuration Output**

```json showLineNumbers={false}
{
  "imageHeight": "auto"
}
```

---

**User Interface Output**

![output](/_fern-img/fb82cb9d813648ecc158f6ac27b467786ea1ef27af83cfed2305aab1df59892a.webp)

---

**JSON Schema**

| Property                         | Type   | Description                                                                         | Example             |
| -------------------------------- | ------ | ----------------------------------------------------------------------------------- | ------------------- |
| `type`                           | string | The type of setting component to display.                                           | select              |
| `label`                          | string | The user friendly message to inform the user how this setting will be used.         | "Image height (px)" |
| `id`                             | string | The variable name where the setting value will be available in the widget template. | "imageHeight"       |
| `default`                        | string | The default value to use when rendering the widget for the first time.              | auto                |
| `typeMeta`                       | object | Additional information needed based on the selected setting type.                   |                     |
| `typeMeta.selectOptions`         | array  |                                                                                     |                     |
| `typeMeta.selectOptions[].label` | string |                                                                                     | Auto                |
| `typeMeta.selectOptions[].value` | string |                                                                                     | auto                |