wix-cli-site-plugin
Wix Site Plugin Builder
Creates site plugin extensions for Wix CLI applications. Site plugins are custom elements that integrate into predefined slots within Wix business solutions (like Wix Stores, Wix Bookings, Wix eCommerce), extending their functionality and user experience.
Site owners can place site plugins into UI slots using the plugin explorer in Wix editors.
Quick Start Checklist
Follow these steps in order when creating a site plugin:
- Create plugin folder:
src/extensions/site/plugins/<plugin-name>/ - Create
<plugin-name>.tsxextendingHTMLElementwithobservedAttributes - Create
<plugin-name>.panel.tsxwith WDS components andwidget.getProp/setProp - Create
<plugin-name>.extension.tswithextensions.sitePlugin()and unique UUID - Update
src/extensions.tsto import and use the new extension
Architecture
Site plugins consist of three required files:
More from wix/skills
wds-docs
Wix Design System component reference. Use when building UI with @wix/design-system, choosing components, or checking props and examples. Triggers on "what component", "how do I make", "WDS", "show me props", or component names like Button, Card, Modal, Box, Text.
329wix-cli-dashboard-page
Use when building admin interfaces, management pages, CRUD operations, or dashboard configuration UIs. Triggers include dashboard, admin panel, data management, settings pages.
289wix-cli-embedded-script
Use when adding tracking code, advertising pixels, third-party integrations, popups, banners, or client-side JavaScript to sites. Triggers include embed, inject, script, third-party integration, DOM injection, Google Analytics, Facebook Pixel, tracking pixel, chat widget, popup, coupon popup, custom JavaScript, site script.
289wix-cli-dashboard-modal
Use when adding popup forms, confirmations, or detail views to Wix dashboards; creating reusable dialog components across dashboard pages; showing context-specific information in overlays; opening modals from dashboard pages; or passing data between dashboard pages and modals. Do NOT use for static content (use dashboard pages instead) or site-facing UI (use site widgets/embedded scripts).
289wix-cli-service-plugin
Use when implementing service plugin extensions that inject custom backend logic into existing Wix business solution flows or introduce new flows to Wix sites (eCommerce, Bookings, etc.). Triggers include SPI, service plugin, backend flow, business logic, custom shipping rates, additional fees, tax calculation, checkout validation, discount triggers, gift cards, eCommerce customization, bookings staff sorting.
289wix-cli-site-widget
Use when building interactive widgets, custom data displays, or configurable site components with settings panels. Triggers include widget, custom element, interactive component, editor component, configurable widget, web component.
289