A custom element site widget is a UI component that Wix users can place and resize on any site page. You define a custom HTML element, and Wix makes it available in the editor as a widget. Wix users configure it through a settings panel you provide, and visitors interact with it on the published site.
An Editor React Component is a separate extension. Wix users also place it on a page, and the editor builds the panels from a manifest. Editor React Components are the placeable widget on Studio Two, and they also run on Wix Harmony. An app's custom element site widget can be installed on a Wix Studio, Wix Editor, Wix Harmony, or Studio Two site. A Studio Two site can't add a custom element directly. That extension isn't available there, so use an Editor React Component instead.
Tip: Site widgets aren't pinnable to a fixed location on the page. If you need a UI element that stays anchored to a page edge, use an embedded script instead.

Use a site widget when you need a movable, resizable UI surface that Wix users can drop onto any page. Common cases include:
A site widget renders in 3 contexts, and the runtime behavior differs across them:
A widget's size and placement are controlled at registration. Width can be stretchable to full page width or fixed. Height can adjust automatically to the widget's content or be set manually by the Wix user. The widget can be set to appear on the site automatically when an app is installed, or to appear in the Add Elements panel for the Wix user to place manually.
In the editor, each widget exposes an action bar with a Settings button that opens the widget's settings panel as an iframe, and optionally a Manage button that links to a dashboard page.
Use Wix APIs at runtime to read site data, respond to visitor interactions, and integrate with Wix business solutions. Wix APIs are available at preview and on the published site, not in the editor's sandbox.
The widget's settings panel is separate from the widget itself. It runs as an iframe in the editor and communicates with the widget through the Editor API to apply configuration changes that visitors see at preview and published time.
In a Wix CLI app, a custom element site widget is a configuration file, an element file, a settings panel, and a CSS module. For the files and the extensions.customElement() fields, see Custom Element Site Widget Extension Files and Code.
Self-managed apps host the element script and the settings panel on their own server, and configure the widget in the App Dashboard. See Add Self-Managed Site Widget Extensions with Custom Elements in Build Apps.
Site widget code runs in 3 contexts with different rules:
What the widget can do at preview and published time is bounded:
For some restricted methods, you can elevate the call from backend code that the widget invokes to gain higher authorization than the calling identity has.
The widget's settings panel is separate code that runs in the editor with the Wix user's identity, like a dashboard extension.
The development path determines how you build a site widget:
Last updated: 4 November 2026