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

# Image Manager

Allows you to display image manager controls for your widget. All uploaded images go to the store’s Image Manager.

---

**Widget Configuration Output**

```json showLineNumbers={false}
{
  "imageUrl": "https://images.unsplash.com/photo-1548768041"
}
```

> **Note**
>
> The “My Images” button allows the user to select from previously uploaded images.

---

**User Interface Output**

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

---

**JSON Schema**

| Property       | Type   | Description                                                                         | Example                                                                                                                                                                                                                                                                                    |
| -------------- | ------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `type`         | string | The type of setting component to display.                                           | "imageManager"                                                                                                                                                                                                                                                                             |
| `id`           | string | The variable name where the setting value will be available in the widget template. | "imageUrl"                                                                                                                                                                                                                                                                                 |
| `default`      | object |                                                                                     |                                                                                                                                                                                                                                                                                            |
| `default.src`  | string |                                                                                     | [https://images.unsplash.com/photo-1487700160041-babef9c3cb55?ixlib=rb-1.2.1\&ixid=eyJhcHBfaWQiOjEyMDd9\&auto=format\&fit=crop\&w=2000\&q=80](https://images.unsplash.com/photo-1487700160041-babef9c3cb55?ixlib=rb-1.2.1\&ixid=eyJhcHBfaWQiOjEyMDd9\&auto=format\&fit=crop\&w=2000\&q=80) |
| `default.type` | string |                                                                                     | IMAGE\_MANAGER                                                                                                                                                                                                                                                                             |