This guide explains how to add a dashboard plugin extension to your new Wix CLI project as part of migrating an app from the legacy Wix CLI.
| Legacy | New |
|---|---|
src/dashboard/plugins/<name>/plugin.json | src/extensions/dashboard/plugins/<name>/<name>.extension.ts |
src/dashboard/plugins/<name>/plugin.tsx | src/extensions/dashboard/plugins/<name>/<name>.tsx |
To move existing files into the new project:
src/extensions/dashboard/plugins/<name>/.plugin.tsx from the legacy project's src/dashboard/plugins/<name>/ folder into the new project's src/extensions/dashboard/plugins/<name>/ folder, and rename it to <name>.tsx..tsx file if needed, including imports of backend code.Don't copy the old plugin.json file. It is replaced by a new .extension.ts file.
In src/extensions/dashboard/plugins/<name>/, create <name>.extension.ts:
| Field | Source | Required |
|---|---|---|
id | id from plugin.json | Yes. Must match legacy value to preserve the extension. |
title | title from plugin.json | Yes |
extends | extends from plugin.json, the parent page this plugin extends | Yes |
component | Path to the .tsx file, relative to src/ | Yes |
Important:
The id must match the value from the legacy plugin.json. Otherwise, the new entry is treated as a separate extension instead of a continuation of the legacy one.
In the new project, in src/extensions.ts, import the extension and add it with .use():
Return to the Test, build, and release step in the main migration guide.
Last updated: 29 June 2026