> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-on-prem/8.5/configure-cortex-xsoar/dashboards-and-reports/dashboards/manage-dashboards.md). # Manage dashboards You can create or edit dashboards according to your organization's requirements. Creating a new dashboard enables designing a personalized interface for specific security investigation needs. This facilitates quick access to critical information and enhances operational effectiveness. Editing an existing dashboard enables security teams to focus on the most relevant information. By presenting only the most relevant data and metrics, investigation and response is more efficient and streamlined. Once you create or edit a dashboard, you can share it with relevant roles to facilitate collaboration and enhance visibility into relevant data and insights across teams.
Create a dashboard 1. To create a new dashboard, select Dashboards & Reports → Dashboards → More Dashboards → **New Dashboard**. 2. Enter a name for the dashboard. 3. Select the date range for a dashboard. From the **Date Range** dropdown list, set the date range for the dashboard. By default, a widget inherits the date range that you specify when creating the widget. If the date range for the report or dashboard does not include the widget date range, the data is blank. To change the widget’s date range, click ![three-dots.jpg](/files/9LBuymlvwhlTsE6utJTE) and select **Use Widget’s date range** or **Use Dashboard’s date range**. By default, the dashboard’s date range is used and the option in the dropdown shows as **Use Widget’s date range**. If you change this to use the widget’s date range, the dropdown then shows the option to **Use Dashboard’s date range**.

Note

Each widget can have its own date range, which can be different from the dashboard's date range.

4. Add a widget to a dashboard. 1. Click ![plus.jpg](/files/iB2tAnkTLWxbhzbM8P1u) to create a custom widget or in the **Widgets Library**, find a relevant existing widget and click **Add**. 2. To edit a widget in the dashboard, select ![three-dots.jpg](/files/9LBuymlvwhlTsE6utJTE) then **Edit widget**. The edits to the widget in the dashboard apply only for the report. If you want to make changes that are available for other users, dashboards, or reports, edit the widget directly in the **Widgets Library** by clicking the pencil edit icon. 3. To add a new widget from the **Widgets Library**, follow the procedure in [Create a widget using the widget builder](/cortex-xsoar-8-on-prem/8.5/configure-cortex-xsoar/dashboards-and-reports/widgets/create-a-widget-using-the-widget-builder.md). 4. Click **Save**. 5. **Save** the dashboard. If you select **Save Version**, you can view a history of the changes made to your dashboard and you can revert to previous versions.
Edit a dashboard 1. Go to Dashboards & Reports → Dashboards. 2. Select the dashboard you want to edit. 3. Click ![cog-wheel-8.png](/files/Ku9rVsi0t660C1bYRzVq) and select **Edit**, or for an out-of-the-box dashboard click **Duplicate**. 4. Enter a name for the dashboard. 5. Select the date range for a dashboard. From the **Date Range** dropdown list, set the date range for the dashboard. By default, a widget inherits the date range that you specify when creating the widget. If the date range for the report or dashboard does not include the widget date range, the data is blank. To change the widget’s date range, click ![three-dots.jpg](/files/9LBuymlvwhlTsE6utJTE) and select **Use widget’s date range** or **Use dashboard’s date range**. By default, the dashboard’s date range is used and the option in the dropdown shows as **Use widget’s date range**. If you change this to use the widget’s date range, the dropdown then shows the option to **Use dashboard’s date range**.

Note

Each widget can have its own date range, which can be different from the dashboard's date range.

6. Add a widget to a dashboard. 1. Click ![plus.jpg](/files/iB2tAnkTLWxbhzbM8P1u) to create a custom widget or in the **Widgets Library**, find a relevant existing widget and click **Add**. 2. To edit a widget in the dashboard, select ![three-dots.jpg](/files/9LBuymlvwhlTsE6utJTE) then **Edit widget**. The edits to the widget in the dashboard apply only for the report. If you want to make changes that are available for other users, dashboards, or reports, edit the widget directly in the **Widgets Library** by clicking the pencil edit icon. 3. To add a new widget from the **Widgets Library**, follow the procedure in [Create a widget using the widget builder](/cortex-xsoar-8-on-prem/8.5/configure-cortex-xsoar/dashboards-and-reports/widgets/create-a-widget-using-the-widget-builder.md) . 4. Click **Save**. 7. **Save** the dashboard. If you select **Save Version**, you can view a history of the changes made to your dashboard and you can revert to previous versions.
Share a dashboard 1. Go to the dashboard to share. 2. Click ![cog-wheel-8.png](/files/Ku9rVsi0t660C1bYRzVq) and select **Share**. To share an out-of-the-box dashboard, you need to duplicate it and share the copy. 3. In the **Share dashboard** dialog box, select the roles with whom you would like to share this dashboard and their permission levels. Dashboards can be shared for all roles or for specific roles, with the following permission levels. * **Read only**: Copy, export, import and remove the dashboard (cannot share or edit). Once shared, regardless of who creates the dashboard, any user who has read and write permissions can change the sharing options including to stop sharing. If an analyst who created and shared the dashboard deletes the shared dashboard, it is removed from all users. * **Read & Edit**: Edit, copy, share, export import, and remove the dashboard. For example, analysts may want to enable and encourage team-based dashboards, so that dashboards can be edited and maintained by more than a single user.

Note

Only dashboard owners can delete their dashboards.

4. Click **Save**. The dashboard is now shared among other analysts in the specified role or all roles. 5. (Users) To add a shared dashboard, from the home page, select **More Dashboards** and select the shared dashboard from the drop-down. Instead of a user adding the dashboard, you can send the URL to the user, after sharing the dashboard.

Note

If you are using a remote repository, all dashboards are automatically shared in the development environment. As a result, the Share option can not be selected from the Settings menu.

6. To stop sharing a dashboard: 1. Click ![cog-wheel-8.png](/files/Ku9rVsi0t660C1bYRzVq) and select **Share**. 2. In the **Share dashboard** dialog box, remove all the roles. 3. Click **Save**.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-on-prem/8.5/configure-cortex-xsoar/dashboards-and-reports/dashboards/manage-dashboards.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.