> 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: Display a Site Widget in the Add Panel and Site Dashboard

## Article: Display a Custom Element Site Widget in the Add Elements Panel

## Article Link: https://dev.wix.com/docs/build-apps/develop-your-app/extensions/site-extensions/site-widgets/display-a-site-widget-in-the-add-panel-and-site-dashboard.md

## Article Content:

# Display a Site Widget in the Add Panel and Site Dashboard

You can display your [site widget](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/site-extensions/site-widgets/about-site-widget-extensions.md) in the following areas: 

* The **Add Elements** panel in the site editor.
* The **Manage Apps** page in the site dashboard.

> **Note**: [Essential widgets](https://dev.wix.com/docs/build-apps/develop-your-app/extensions/site-extensions/site-widgets/about-site-widget-extensions.md#essential-widgets) are automatically added to a site when an app is installed and can only appear once, so they don't appear in the **Add Elements** panel or the **Manage Apps** page. 

When creating your site widget, configure the following content:

* A short description of the widget's functionality, which appears in an info tooltip.
* A preview image showcasing the widget's appearance.

Learn more about creating a custom element site widget:

* [Add a Custom Element Site Widget Extension in the CLI](https://dev.wix.com/docs/wix-cli/guides/extensions/site-extensions/custom-elements/add-a-custom-element-extension.md)
* [Add Self-hosted Site Widget Extensions with Custom Elements](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/site-extensions/site-widgets-and-plugins/add-self-hosted-site-widget-extensions-with-custom-elements.md#add-self-hosted-site-widget-extensions-with-custom-elements)

## Add Elements panel

Your widget appears in the panel's **App Widgets** section. Wix users can find it there and add it to any page on a site.

The following image shows how a widget appears in the panel:

![widget-add-panel](https://wixmp-833713b177cebf373f611808.wixmp.com/images/e9a5c96cf471fdc56cdf7655f9295ece.png)

## Manage Apps page

Your widget appears in the **Manage Apps** page of the site dashboard. Wix users can find it listed under your app and add it to any page on a site.

The following image shows how a widget appears in the Manage Apps page:

![widget-manage-apps](https://wixmp-833713b177cebf373f611808.wixmp.com/images/21a83f0da45c7570163c4d020ee42f0c.png)

## Guidelines for creating a preview image

The preview image you provide appears in both the **Add Elements** panel and the **Manage Apps** page. When creating your preview image, keep the following content and technical guidelines in mind. 

### Content guidelines

* The image should be a visual representation of the preset. It's not a banner or an ad.
* If your widget displays dynamic content, include dummy content but avoid Lorem Ipsum.

### Technical guidelines

* Use a screenshot of the widget to capture its actual dimensions and original pixel size.
* Save at the highest quality and avoid compression.
* Supported formats: JPG or PNG