> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Dashboard Menu Plugin Extension Files and Code

## Article: Dashboard Menu Plugin Extension Files and Code

## Article Link: https://dev.wix.com/docs/wix-cli/legacy-clis/legacy-wix-cli-for-apps/supported-extensions/dashboard-extensions/dashboard-menu-plugins/dashboard-menu-plugin-extension-files-and-code.md

## Article Content:

# Dashboard Menu Plugin Extension Files and Code

<blockquote classname="warning">

**Deprecated**

The Wix CLI for Apps is deprecated and no longer receives updates or new features. New projects should use the unified [Wix CLI](https://dev.wix.com/docs/wix-cli/guides/about-the-wix-cli.md). [Determine which CLI your project uses](https://dev.wix.com/docs/wix-cli/guides/development/determine-which-cli-your-project-uses.md).

</blockquote>

In your app project, the configuration files for dashboard menu plugins are located in the `src/dashboard/menu-plugins` folder.

Each menu plugin is defined in its own subfolder with the name you provided during the installation process. Each subfolder contains one file, `plugin.json`, that has the plugin configuration details.

## Extension configuration metadata (plugin.json)

The `plugin.json` file contains the dashboard menu plugin configuration details. You can edit its fields manually to modify its appearance or behavior. However, do not change the extension's `id` field, as this is auto-generated by Wix and must remain unique across all extensions.

| Field  | Type  | Description  |
|--------|-------|--------------|
| `id`     | String  | Extension's unique identifier. The ID is used to register the menu plugin in the [app dashboard](https://dev.wix.com) and must be unique across all extensions in the app. |
| `title`  | String  | Text of the menu item the extension adds. |
| `subtitle` | String | Secondary text that appears in the menu just below the title.  |
| `iconKey`  | String | Icon that appears next to your extension's title. Select a normal-size [icon from the Wix Design System](https://www.wix-pages.com/wix-design-system-employees/?path=/story/foundations-icons--icons) and paste its name. |
| `extends`  | String | Slot ID into which the extension plugs in. Find [the relevant dashboard slot](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-plugins/supported-wix-app-dashboard-pages/about-dashboard-page-slots.md) for your app. |
| `action`  | Object  | Navigation configuration object that determines the action taken when the extension is clicked. Possible values are either `openModal` or `navigateToPage`. |
| `action.openModal`  | Object  | Dashboard modal configuration object. Contains the ID of the dashboard modal to display when the extension's menu item is clicked, along with additional parameters. |
| `action.openModal.componentId`  | String | ID of the dashboard modal to display when the extension's menu item is clicked. |
| `action.openModal.componentParams`  | Object | Additional configuration parameters you can pass to the dashboard modal. Note that if an additional parameter shares a name with a [parameter passed by the slot](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-plugins/about-dashboard-plugin-extensions.md#slots-and-plugin-apis), the additional parameter overrides the slot's parameter. |
| `action.navigateToPage`  | Object  | Page navigation configuration object. Contains the ID of the target dashboard page, as well as additional configuration parameters. |
| `action.navigateToPage.pageId`  | String | ID of the dashboard page to which site administrators are directed. |
| `action.navigateToPage.relativeUrl`  | String  | URI segment appended to the base URI of the target dashboard page. It can include path segments, search parameters, and hash information. |

Here's an example `plugin.json` file:

```json
{
  "id": "e357ba12-da11-4bb3-b5db-45921fcb36e4",
  "title": "Activity Statistics",
  "subtitle": "Show a graph of recent activity",
  "iconKey": "Activity",
  "extends": "084a82b9-c9a5-4bb0-bf82-e071f2f79d2a",
  "action": {
  // One of:
    "openModal": {
      "componentId": "9157ba1d-da11-4bb3-a5db-45911fcb36e5",
      "componentParams": {
        "origin": "calendar-page"
      }
    },
    "navigateToPage": {
      "pageId": "e357ba12-da11-4bb3-b5db-45921fcb36e4",
      "relativeUrl": "?origin=import-modal"
    }
  }
}
```