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

# Widgets

Create and manage widget templates, widgets, regions, and placements.

## Subresources

### Widget templates

[Widget templates](/developer/api-reference/rest/admin/content/widgets/widget-template) are reusable Handlebars-enabled HTML templates that define the structure of the widget on a page.

### Widgets

[Widgets](/developer/api-reference/rest/admin/content/widgets/widget) are units of content placed on specific pages in a Stencil theme. Widgets consist of a widget configuration and a widget template UUID and render as part of the storefront’s HTML.

### Regions

[Regions](/developer/api-reference/rest/admin/content/widgets/regions) are specific locations in the Stencil theme template files where you can place a widget.

### Placements

[Placements](/developer/api-reference/rest/admin/content/widgets/placement) determine the region where you place widgets and in what order.

## Additional Information

* [Widgets API Overview](/developer/docs/admin/widgets-and-scripts)
* [Widget UI Schema](/developer/docs/admin/widgets-and-scripts/input-reference/schema)
* [Widget UI Input Types](/developer/docs/admin/widgets-and-scripts/input-reference/schema)

> Build amazing commerce solutions powered by the BigCommerce platform

## Docs

- [Admin Content: Widgets](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets)

## API Docs

- Admin Content: Widgets > Placement [List Placements](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/placement/get-placements.md)
- Admin Content: Widgets > Placement [Create Placement](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/placement/create-placement.md)
- Admin Content: Widgets > Placement [Get Placement](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/placement/get-placement.md)
- Admin Content: Widgets > Placement [Update Placement](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/placement/update-placement.md)
- Admin Content: Widgets > Placement [Delete Placement](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/placement/delete-placement.md)
- Admin Content: Widgets > Regions [List Theme Regions](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/regions/get-content-regions.md)
- Admin Content: Widgets > Widget [List Widgets](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget/get-widgets.md)
- Admin Content: Widgets > Widget [Create Widget](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget/create-widget.md)
- Admin Content: Widgets > Widget [Get Widget](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget/get-widget.md)
- Admin Content: Widgets > Widget [Update Widget](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget/update-widget.md)
- Admin Content: Widgets > Widget [Delete Widget](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget/delete-widget.md)
- Admin Content: Widgets > Widget Template [List Widget Templates](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget-template/get-widget-templates.md)
- Admin Content: Widgets > Widget Template [Create Widget Template](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget-template/create-widget-template.md)
- Admin Content: Widgets > Widget Template [Render Widget Template](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget-template/preview-widget.md)
- Admin Content: Widgets > Widget Template [Get Widget Template](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget-template/get-widget-template.md)
- Admin Content: Widgets > Widget Template [Update Widget Template](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget-template/update-widget-template.md)
- Admin Content: Widgets > Widget Template [Delete Widget Template](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/widget-template/delete-widget-template.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/openapi.json)
- [OpenAPI YAML](https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/widgets/openapi.yaml)