# Dashboards list and folders

The Dashboards List has been upgraded for a smoother navigation experience. **All Dashboards** is now displayed in the top header for quick access from anywhere in a dashboard. The panel is wider for easier browsing, and a new 3-dot menu provides quick actions for each dashboard and folder. Import is now its own separate action, independent of the **New** button.

## Open the Dashboards List

Select the **Dashboards list** icon in the top toolbar of any Custom Dashboard. The panel opens and displays all dashboards you have access to, grouped by folder.

To navigate back to the list from inside a dashboard, select **All Dashboards** in the header.

## Browse and search

Folders are collapsed by default. Select the arrow next to a folder name to expand it and see the dashboards inside.

Use the **Search Dashboard** bar at the top of the list to filter across all folders by dashboard name.

## Create a new dashboard

Select **New** in the Dashboards List to create a new blank dashboard.

## Import a dashboard

1. Select **Import** in the Dashboards List.
1. Upload or paste the dashboard JSON.

The imported dashboard appears in the list and can be moved into any folder.

## Permissions

Creating, renaming, and deleting folders requires the `DASHBOARD-FOLDER:MANAGE` permission. For details, see [Permissions List](/docs/user-guides/account-management/user-management/create-roles-and-permissions/permissions-list/).

## Organize dashboards with folders

### Create a folder

Select the **New folder** icon next to the search bar. Enter a name and confirm.

### Move a dashboard into a folder

Drag a dashboard from the list and drop it onto the target folder. The dashboard moves into that folder immediately.

### Rename or delete a dashboard or folder

Select the **3-dot menu** next to the dashboard or folder name and choose **Rename** or **Delete**.

## API

### HTTP

| **API Name**                                                                                        | **Usage**                                                                                                                                                                                                                                                                                      |
| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Dashboards](https://docs.coralogix.com/api-reference/v5/dashboard-service/overview)                | The Dashboards API provides programmatic access to Custom Dashboards. Use it to create and update dashboards, manage their layout, widgets, variables, filters, annotations, actions, time frame, and constants. This is the API behind everything you build through the Custom Dashboards UI. |
| [Dashboard Folders](https://docs.coralogix.com/api-reference/v5/dashboard-folders-service/overview) | The Dashboard Folders API manages the folder hierarchy that organizes your Custom Dashboards. Use it to create, rename, move, and delete folders, and to look up a folder's `FolderPath` for permission inheritance and cross-references from dashboards.                                      |

## Related resources

- [Custom Dashboards overview](https://coralogix.com/docs/user-guides/custom-dashboards/introduction/index.md)
- [Manage Dashboard Settings](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/manage-dashboard-settings/index.md)
- [Import and Export Custom Dashboards](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/import-and-export-custom-dashboards/index.md)
- [Dashboard Sections](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/sections/index.md)