> 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

# Method name: addSitePlugin(pluginId: string, options: AddSitePluginOptions)

# Method package: wixDashboard

# Method menu location: wixDashboard --> addSitePlugin

# Method Link: https://dev.wix.com/docs/velo/apis/wix-dashboard/add-site-plugin.md

# Method Description:

Adds a site plugin to one of the slots supported in an app created by Wix. You can specify a single slot in which you want to add the plugin, or add the plugin to one of the available slots based on a list of prioritized slots that you configure in the plugin's installation settings in your [app's dashboard](https://manage.wix.com/studio/custom-apps).

> **Note:** This function can only be used in page code files for dashboard pages created in [Wix Editor](https://dev.wix.com/docs/develop-websites/articles/coding-with-velo/frontend-code/dashboard-admin-pages/add-a-dashboard-page.md) or with [Wix Blocks](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/wix-blocks/dashboard-pages/build-a-dashboard-page-in-blocks.md).

The `addSitePlugin()` function returns a Promise that resolves when the plugin is added to the site.

> **Note:** To use this function, Your app must have a site plugin extension. Learn more about [site plugins](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/site-extensions/site-plugins/about-site-plugin-extensions.md).



# Method Code Examples:

*** Note: do not assume any prop names or enum values other than the ones in the example.

## Add a site plugin to a specific slot

```javascript
import { addSitePlugin } from 'wix-dashboard';

// ...

const pluginId = '975bffb7-3c04-42cc-9840-3d48c24e73d5';
const pluginPlacement = {
  appDefinitionId: '13d21c63-b5ec-5912-8397-c3a5ddb27a97',
  widgetId: 'a91a0543-d4bd-4e6b-b315-9410aa27bcde',
  slotId: 'slot1',
};

addSitePlugin(pluginId, { placement: pluginPlacement })
  .then(() => {
    console.log('Plugin added successfully');
  })
  .catch(error => {
    console.error('Error adding plugin:', error);
  });
```

## Add a site plugin without specifying a slot

```javascript
import { addSitePlugin } from 'wix-dashboard';

// ...

const pluginId = '975bffb7-3c04-42cc-9840-3d48c24e73d5';

addSitePlugin(pluginId, {})
  .then(() => {
    console.log('Plugin added successfully');
  })
  .catch(error => {
    console.error('Error adding plugin:', error);
  });
```

---