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.
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: Components that can be placed anywhere on a Wix site. Often used for testimonial showcases, custom forms, and interactive calculators.
- Editor React Components: React-based widgets that integrate natively with the Wix Harmony editor, with Wix-managed editing controls. Only supported on Wix Harmony 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.
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 are an app concept. They're built inside Wix apps and added to a site when a Wix user installs the app. Site developers and headless projects reach equivalent outcomes through path-specific mechanisms instead.
- Sites: You can add site pages and widgets directly in the Wix Editor or Wix Studio 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 site extensions using the Wix CLI. See each extension type's article for the CLI guide.
- Self-managed apps: Build site extensions using the self-hosted framework. 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.