Migrate a Dashboard Menu Plugin Extension

This guide explains how to add a dashboard menu plugin extension to your new Wix CLI project as part of migrating an app from the legacy Wix CLI.

Folder structure

LegacyNew
src/dashboard/menu-plugins/<name>/plugin.jsonsrc/extensions/dashboard/menu-plugins/<name>/<name>.extension.ts

Dashboard menu plugins are configuration-only. There is no component file.

Step 1 | Create the extension file

In the new project:

  1. Create the folder src/extensions/dashboard/menu-plugins/<name>/.
  2. Inside the folder, create <name>.extension.ts:
Copy
FieldSourceRequired
idid from plugin.jsonYes. Must match legacy value to preserve the extension.
titletitle from plugin.jsonYes
extendsextends from plugin.json, the parent page this plugin extendsYes
iconKeyiconKey from plugin.jsonYes. Use '' if not set in legacy config.
actionaction object from plugin.jsonYes. Use { navigateToPage: { pageId: '' } } if not set in legacy config.
subtitlesubtitle from plugin.jsonNo

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.

Step 2 | Register the extension

In the new project, in src/extensions.ts, import the extension and add it with .use():

Copy

Step 3 | Return to the main migration guide

Return to the Test, build, and release step in the main migration guide.

Last updated: 29 June 2026

Did this help?