About Site Extensions

Site extensions add UI and behavior to a Wix site's live, visitor-facing pages. Your custom site extensions render alongside the site's own pages and widgets, becoming part of what visitors experience on the published site.

Site extension types

Wix supports the following kinds of site extensions:

  • Site pages: Full visitor-facing pages added to a Wix site. Often used for member portals, custom catalogs, and specialized landing pages.
  • Site widgets: Custom element components that Wix users place on a page. Often used for testimonial showcases, custom forms, and interactive calculators. Editor React Components are a separate extension.
  • Editor React Components: React-based widgets that integrate natively with the editor, with Wix-managed editing controls. Apps can include them for Studio Two and Wix Harmony sites. When you extend a site directly, they're only available in Studio Two.
  • Context providers: Logical components that share state and behavior with visual components through editor binding. Studio Two calls them Data Sources in the editor.
  • Function libraries: Collections of reusable, stateless functions that Wix users connect to components through editor binding. They're only available for Studio Two sites.
  • Site plugins: Components embedded into slots exposed by Wix business solution pages and widgets. Often used for adding a custom shipping calculator to a Stores product page, or appending custom fields to a Bookings page.
  • Embedded scripts: Raw HTML or JavaScript fragments injected into a site's pages, not placed by the Wix user. Often used for analytics, tracking pixels, and 3rd-party integrations.

How site extensions work

Each site extension is registered with the platform. The registration declares the extension's type, where it appears on the site, and where its code lives. After installation, the site loads and renders the registered extensions at the appropriate points in each page's lifecycle.

At runtime on the live site, site extensions can interact with Wix through Wix APIs to read site data, respond to visitor interactions, and integrate with Wix business solutions.

Site extensions across development paths

Most site extensions are built inside Wix apps and added to a site when a Wix user installs the app. Studio Two sites can also define some site extensions directly in the site project.

  • Sites:
    • Studio Two: Add supported site extensions directly to the site project through the Wix Extension Builder, including ERCs, Data Sources, function libraries, embedded scripts, and site plugins. The custom element extension isn't available on the site, so placeable widgets added in the site project are Editor React Components. An installed app can still add its own custom element widget.
    • Wix Studio and Wix Editor: Add site pages and widgets without using an extension. For more advanced customization, write site code using the JavaScript SDK.
  • Wix-managed headless projects: Don't support site extensions. Headless projects use their own frontend, so there's no Wix-managed site to inject pages, widgets, plugins, or scripts into.
  • Self-managed headless projects: Don't support site extensions. Headless projects use their own frontend, so there's no Wix-managed site to inject pages, widgets, plugins, or scripts into.
  • Wix-managed apps: Build supported site extensions using the Wix CLI. Function libraries aren't supported. See each extension type's article for the CLI guide.
  • Self-managed apps: Build supported site extensions using the self-hosted framework. Function libraries aren't supported. See each extension type's article for implementation details.
  • Blocks apps: Build site widgets and site plugins using Wix Blocks. Blocks apps don't support site pages or embedded scripts.

Last updated: 4 November 2026

Did this help?