wix-cli-dashboard-plugin

Creates dashboard plugin widgets that extend Wix first-party business app dashboard pages.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-cli-dashboard-plugin-thisisjaymehta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wix-cli-dashboard-plugin
Source: https://github.com/thisisjaymehta/login-with-email-test/tree/main/.agents/skills/wix-cli-dashboard-plugin
Command: npx skills add https://github.com/thisisjaymehta/login-with-email-test --skill wix-cli-dashboard-plugin-thisisjaymehta

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @wix/astro, @wix/design-system, @wix/dashboard, and includes references (resource) components.

What problem does it solve? Building widgets that embed into Wix dashboard pages requires knowing exact slot IDs, the dashboardPlugin builder API, and a mandatory two-step extension registration process. This Skill guides the creation of dashboard plugins for Wix CLI apps so the widget actually renders inside pages managed by Wix Stores, Bookings, Blog, eCommerce, Events, and Restaurants. ## Core Features & Use Cases - Plugin Scaffolding: Generates the <plugin-name>.extension.ts builder file with a unique UUID and the React .tsx component wrapped in WixDesignSystemProvider. - Slot Targeting: Provides a complete reference of slot IDs per Wix business app, including parameters like orderId, staffResourceId, and eventId passed to the plugin. - Host Page Communication: Implements observeState() from the Wix Dashboard SDK so plugins receive live data from the host dashboard page. - Use Case: Add a fulfillment status widget to the Wix eCommerce order page by targeting slot cb16162e-42aa-41bd-a644-dc570328c6cc and reading order data via observeState(). ## Quick Start Create a dashboard plugin for the Wix Blog posts page that displays a promotional banner and register it in src/extensions.ts.

Frequently Asked Questions about wix-cli-dashboard-plugin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Wix dashboard plugin with the Wix CLI?

Create a folder under src/extensions/dashboard/plugins/, add an extension.ts file using extensions.dashboardPlugin() with a unique UUID and slot ID, and a .tsx React component. Then register the extension in src/extensions.ts or the plugin will not appear.

How do I find the slot ID for a Wix dashboard page?

Each Wix business app exposes documented slot IDs, such as 46035d51-2ea9-4128-a216-1dba68664ffe for the Blog Posts page. Set this ID in the extends field of the dashboardPlugin builder; never invent slot IDs.

How does a dashboard plugin receive data from the host page?

Use observeState() from the @wix/dashboard SDK inside a useEffect to subscribe to parameters passed by the host page, such as orderId or staffResourceId. Some apps also expose typed prop interfaces from their dashboard packages.

Why is my Wix dashboard plugin not appearing on the page?

The two common causes are missing registration in src/extensions.ts and an incorrect slot ID in the extends field. Verify the extension is imported and used, and confirm the slot ID matches the Slots Reference.

When should I use a dashboard plugin versus a dashboard page?

Use a dashboard plugin to embed a widget into an existing slot on a Wix first-party app page. For a standalone dashboard page you fully control, use a dashboard page extension instead; for site-facing UI, use site widgets or site plugins.