> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> 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`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - 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 Sidebar Categories

## Article: Dashboard Sidebar Categories

## Article Link: https://dev.wix.com/docs/overview/extensions-framework/dashboard-extensions/dashboard-sidebar-categories.md

## Article Content:

# Dashboard Sidebar Categories

A dashboard sidebar category groups an app's [dashboard pages](https://dev.wix.com/docs/overview/extensions-framework/dashboard-extensions/dashboard-pages.md) under a single entry in the dashboard sidebar. Site owners see the category's title, usually the app's name, with the app's pages listed under it. A sidebar category has no UI or code of its own. It's a label that the app's dashboard pages link to.

![A dashboard sidebar category grouping an app's dashboard pages in the dashboard sidebar](https://wixmp-833713b177cebf373f611808.wixmp.com/images/53e2f65582385e2d15f5b1901e8f2bfd.png)

## When to use a dashboard sidebar category

Use a dashboard sidebar category when your Wix CLI project has more than one dashboard page. Common cases include:

- Grouping an app's settings, reports, and management pages under the app's name.
- Splitting a large app's dashboard pages into more than one group, like a group for store setup pages and a group for report pages.

Without a sidebar category, each dashboard page of a Wix CLI app appears in the sidebar as its own entry under **Apps**, as if it were a separate app. The dashboard pages of a Wix-managed headless project appear under **Custom Pages**.

Wix groups an app's dashboard pages automatically when they're added in the app dashboard or in Wix Blocks, so those apps don't need a sidebar category.

## Sidebar placement and order

A sidebar category is an entry in the dashboard sidebar, under **Apps**, and its pages appear under its title. A page that isn't in a category is its own entry under **Apps**, at the same level as the app's sidebar categories. In a Wix-managed headless project, a page that isn't in a category appears under **Custom Pages** instead.

Priority sets the order. Each sidebar category and each page can have a priority. Smaller numbers appear higher, and the default priority is 0.

The sidebar applies priority at two levels:

- Under **Apps**, it orders an app's sidebar categories together with the app's pages that aren't in a category.
- In a sidebar category, it orders the category's pages.

<details>
<summary>Example of sidebar order</summary>

An app has the following:

- A sidebar category named **Reports** with a priority of 1.
- A dashboard page named **Revenue** in the **Reports** category, with a priority of 1.
- A dashboard page named **Traffic** in the **Reports** category, with a priority of 3.
- A dashboard page named **Settings** with a priority of 2, not in a category.

The sidebar lists them under **Apps** in the following order:

- **Reports**
    - **Revenue**
    - **Traffic**
- **Settings**

![The Apps menu in the dashboard sidebar, showing the Reports sidebar category and the Settings page, with the Revenue and Traffic pages in a second menu next to Reports](https://wixmp-833713b177cebf373f611808.wixmp.com/images/bc907e8bc8bac8b0bd113f5edd894ed5.png)

**Settings** has a smaller number than **Traffic**, but the sidebar doesn't compare them. It orders **Settings** together with **Reports**, and it orders **Traffic** among the pages in **Reports**.

</details>

Some cases change what the sidebar shows:

- A sidebar category with only one page shows as that page, without the category's title.
- A sidebar category with no pages doesn't appear.
- A page that links to a sidebar category that doesn't exist doesn't appear in the sidebar. In a Wix-managed headless project, it appears under **Custom Pages** instead.

## Sidebar category definition

Sidebar categories are configured rather than coded. In Wix CLI projects, a dashboard sidebar category is a single configuration file that declares the category's ID, its title, and optionally its priority. Each dashboard page links to a sidebar category by setting the page's category ID to the category's ID. For the file and configuration fields, see [Dashboard Sidebar Category Extension Files and Code](https://dev.wix.com/docs/dashboard-extensions/dashboard-sidebar-categories/dashboard-sidebar-category-extension-files-and-code.md).

## Dashboard sidebar categories across development paths

The development path determines how you add a dashboard sidebar category:

- **Sites:** Create a private app that registers the sidebar category and its dashboard pages, and install that app on the site.
- **Wix-managed headless projects:**
  - **Full Wix integration (Astro):** Use the Wix CLI. See [Add Dashboard Sidebar Category Extensions with the Wix CLI](https://dev.wix.com/docs/go-headless/wix-managed-headless/full-integration-astro/extensions/dashboard/dashboard-sidebar-categories/add-dashboard-sidebar-category-extensions-with-the-wix-cli.md) in Go Headless.
  - **Other frameworks:** Don't support dashboard sidebar category extensions directly. Follow the same approach as self-managed headless projects.
- **Self-managed headless projects:** Create a private app that registers the sidebar category and its dashboard pages, and install that app in your headless project.
- **Wix-managed apps:** Use the Wix CLI. See [Add Dashboard Sidebar Category Extensions with the Wix CLI](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/dashboard/dashboard-sidebar-categories/add-dashboard-sidebar-category-extensions-with-the-wix-cli.md) in Build Apps.
- **Self-managed apps:** Don't add sidebar categories. When an app has more than one dashboard page in the app dashboard, Wix groups the pages automatically.
- **Blocks apps:** Don't add sidebar categories. When an app has more than one Blocks dashboard page, Wix groups the pages automatically.