> 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: Add Dashboard Menu Plugin Extensions 

## Article: Add Dashboard Menu Plugin Extensions 

## Article Link: https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-plugins/dashboard-menu-plugins/add-dashboard-menu-plugin-extensions.md

## Article Content:

# Add Dashboard Menu Plugin Extensions in the App Dashboard

This article describes how to add a [dashboard menu plugin](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-plugins/dashboard-menu-plugins/dashboard-menu-plugin-extensions.md) into a pre-configured slot in an app built by Wix, using the [app dashboard](https://dev.wix.com/docs/build-apps/develop-your-app/app-dashboard-setup/about-the-app-dashboard.md).

> **Note**:
>
> - Alternatively, you can add a dashboard menu plugin extension with the [Wix CLI](https://dev.wix.com/docs/wix-cli/guides/extensions/dashboard-extensions/dashboard-menu-plugins/add-dashboard-menu-plugin-extensions.md).
> - You can only add this extension to some apps built by Wix. Learn more about [plugin slots in dashboard pages](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).
> - To minimize errors, instruct your user to install the app built by Wix on their site before installing your app.

## Add a dashboard menu plugin to your app

Add the extension by doing the following:

1. In your app dashboard, click **Extensions** in the sidebar menu.
2. Click **Create Extension**.
3. In the **Choose the extension you want to create** modal, select **Dashboard Menu Plugin** and click **Create**.
4. On the **Dashboard Menu Plugin** extension configuration page, use the JSON editor to configure the following properties:

| Property    | Description        |
| ----------- | ------------------ |
| **extends** | **Required**. The [slot ID](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 the slot your extension plugs into. |
| **hostingPlatform** | **Required**. The Wix platform that hosts the extension. Use `BUSINESS_MANAGER`. |
| **iconKey** | The icon that appears next to your extension in the menu it's added to. 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. |
| **action**| **Required**. What your extension does when clicked. Enter `openModal` to direct site administrators to a dashboard modal, or `navigateToPage` to direct them to another dashboard page. |
| **action.navigateToPage** | When **action** is set to `navigateToPage`, the page navigation configuration object. This contains the ID of the target dashboard page, as well as additional parameters. Learn how to find the [extension ID](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/find-a-dashboard-extension-id.md). |
| **action.navigateToPage.pageId** | **Required** when using `navigateToPage`. The ID of the dashboard page to which site administrators are directed. Learn how to find the [extension ID](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/find-a-dashboard-extension-id.md). |
| **action.navigateToPage.relativeUrl** | A URI segment attached to the base URI of the target dashboard page. It can include path segments, search parameters and hash information. |
| **action.openModal** | When **action** is set to `openModal`, the dashboard modal configuration object. This contains the ID of the dashboard modal to display, as well as additional parameters. </br> </br> Learn more about [dashboard modals](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-modals/about-dashboard-modals.md). |
| **action.openModal.componentId** | **Required** when using `openModal`. The ID of the dashboard modal to display when the extension is clicked. Learn how to find the [extension ID](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/find-a-dashboard-extension-id.md). |
| **action.openModal.componentParams** | Additional parameters you can pass to your [dashboard modal](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-modals/about-dashboard-modals.md). 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.  |
| **componentName** | A unique name for this extension that appears in the app dashboard. |

5. Click **Save**.

When the site admins clicks the dashboard menu plugin extension, they are directed to the specified dashboard page or shown the modal.

## See also

- [About Dashboard Menu Plugin Extensions](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-plugins/dashboard-menu-plugins/dashboard-menu-plugin-extensions.md)
- [About Dashboard Page Extensions](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-pages/about-dashboard-page-extensions.md)
- [About Dashboard Modals](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/dashboard-extensions/dashboard-modals/about-dashboard-modals.md)