---
title: Working with Dashboards
slug: neurons-for-itsm/admin-user-help/enu/latest/working-with-dashboards
createdAt: 2026-07-14T19:16:31.618Z
---

**Role** : **Administrator**

- [About Dashboards](docId\:gXhuD4TC-pF2lGHuSckyI)
- [How Dashboards Refresh](docId\:gXhuD4TC-pF2lGHuSckyI)
- [About Dashboard Charts](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Creating a Dashboard](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Modifying a Dashboard](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Adding or Removing Columns or Rows to or from a Dashboard](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Resizing a Dashboard Part](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Deleting a Dashboard](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Assigning a Dashboard to a Role](docId\:gXhuD4TC-pF2lGHuSckyI)
- [Using the Dashboard Center](docId\:NAmwiM_AHfHMj7QIlA1EE)
- [Default Dashboards](docId:7yD5WfVCAAA-LKldpKVJe)
- [Dashboard Examples](docId:_ByEQo3xL4OlO9jXfYHob)

## Overview

Dashboards provide a centralized, visual interface to monitor and analyze key data. You can create, edit, and manage dashboards based on your assigned role and permissions.

## About Dashboards

The administrator defines a default dashboard for each role. You can create dashboards if your role has create permissions. (See [Working with Roles](docId\:rw3TVL9KqwmnIw3MXHaLP) to determine your permissions.)

If your role includes create permissions, you can build your own dashboards. If you also have edit permissions, you can:

- Publish dashboards to specific roles
- Set a dashboard as the default for one or more roles

You can define as many dashboards as required. However, only the default dashboard appears automatically in the workspace. You can have only one default dashboard at a time. When you assign a new default dashboard to a role, the previous default dashboard is no longer the default.

When you first sign in to Neurons for ITSM, the application displays your personal default dashboard. If that dashboard is unavailable, the application displays the default dashboard for your role.

In the workspace, you can choose a different dashboard to view. See also [Supporting a URL in a Dashboard](docId\:f20QpPju1dogcfC-bvotw).

### Parts of the All Dashboards

The **All Dashboards** button provides quick access to dashboards that are available by default or published by other users.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/1tU2ZLmoCgiD-GvyfMBin_all-dashboard.png" position="flex-start" size="40" initialPath="../../Resources/Images/Dashboardimages/all-dashboard.png" githubPath="Content/Resources/Images/Dashboardimages/all-dashboard.png" showCaption="false" width="1808" height="889" darkWidth="1808" darkHeight="889" indent="1"}

From this view, you can perform the following actions:

- **Set as default** - Choose a dashboard and set it as default.
- **Add to my dashboards** - Choose dashboard(s) to add to your personal dashboard list.
- **Pin it** - Pin a dashboard to display it under the Watchlist section.
- **Remove from my dashboards** - Remove dashboard(s) from your personal dashboard list.
- **Create New Dashboard** - Create a new dashboard using dashboard objects.
- **Search** - Use the search field to find information.
- **Close** - Click the icon to close the all dashboard view and return to home page.
- **Edit** - Select a dashboard to edit.
- **Delete** - Select a dashboard to delete.

The following table shows the field and description available in this window.

| Field       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name        | Specifies the title or name of the dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Description | Describes the function of the dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Category    | Identifies the functional group or classification assigned to the dashboard such as Asset Management or Inventory or Service Request.                                                                                                                                                                                                                                                                                                                                                        |
| Published   | Lists the user roles or groups that have permission to access the dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Created     | Indicates the user name who created the dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Modified By | Displays the user name who modified the dashboard recently.                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Modified On | Displays the date and time when the dashboard was last updated.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Actions     | Click the checkbox to select the dashboard and to perform the task you require:<br />- Click **edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} icon, to modify the dashboard information as required.<br />- Click **clone** icon to copy the dashboard to create a new one with the same details.<br />- Click **delete** icon to permanently delete the dashboard. |

## How Dashboards Refresh

Starting in Neurons for ITSM Release 2016.2, dashboard and workspace behavior changed to improve performance particularly the speed at which workspaces open. The updates include:

- **Making changes to a workspace while it is open**: 
  - **Before Release 2016.2**: if you had a top-level tab (workspace) open and made changes in the Configuration Console that affected that workspace, the application automatically displayed those changes.
  - **Starting from Release 2016.2**: You must manually refresh the workspace to see any changes made while it is open.
- **Making changes to a workspace while it is not open**:
  - **Before Release 2016.2**: when you closed a top-level tab (workspace), the application deleted that instance. Reopening the tab created a new instance that reflected any changes made while it was closed.
  - **Starting from Release 2016.2**: closing a top-level tab hides the instance rather than deleting it. Reopening the tab restores the same instance, and you must manually refresh it to view any changes made while it was closed.
- **Using the dashboard auto-refresh timer:**: You can enable an auto-refresh timer for dashboards. Set the timer to refresh dashboard data automatically at intervals ranging from 5 to 60 minutes. You can manually start or stop the auto-refresh at any time by clicking the Stop button on the dashboard. To set auto-refresh, see [Creating a Dashboard](docId\:gXhuD4TC-pF2lGHuSckyI).

## About Dashboard Charts

Depending on your role, dashboards can include charts that provide a graphical view of the data. See [Using Chart Parts and the Chart Wizard](docId\:NAmwiM_AHfHMj7QIlA1EE) for more information on each type of chart.

*Sample Service Desk Manager Dashboard*

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/nX4smYi5Y5rma9htDA_Tn_dashboard-sdm.png" position="flex-start" size="40" initialPath="../../Resources/Images/help-images/dashboard sdm.png" githubPath="Content/Resources/Images/help-images/dashboard sdm.png" showCaption="false" width="1654" height="827" darkWidth="1654" darkHeight="827" indent="1"}

### Interacting with Charts

Charts interact with the data in unique ways:

- Hover over a chart element (such as a bar or pie slice) to view the measured data.
- Click a chart element to drill down the data.
- Click the **toggle legend** icon :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/hDFGW-BLXaC4jxo0-iIov_legend.png" alt caption size="10" width="18" height="16"} to show or hide the chart legend. The legend state persists when you refresh the chart.
- Click the legend to deselect the series.
- Click the **maximize** icon :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/hcyM0C1Qkw5JE0NoJlO3c_maximize.png" alt caption size="10" width="19" height="18"} to zoom in to full window size.
- Click the **close** icon :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/OgAn2icdQcL2MgwSPuES2_close23x22.png" alt caption size="10" width="23" height="22"} to zoom out to dashboard size.
- Click the **export to image** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/6fppVGkqTmKVMCuvvShcu_exportimage.png" alt caption size="10" width="16" height="16"} to save a .png image of the chart to your downloads folder.
- Double-click an item in the chart to view a list of those items.

:::hint{type="info"}
HTML charts do not render correctly if the dataset contains many items. For example, the **Summary** field of the **Incident** business object is a text field that contains unique data for each record. If you attempt to group by this field, every record appears in the bar item and does not render in HTML.
:::

## Creating a Dashboard

1. From the Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace.

:::Paragraph{indent="1"}
The application displays a list of dashboards.
:::

2. From the toolbar, click **New Dashboard**.

:::Paragraph{indent="1"}
The application displays the **Dashboard Center**.
:::

3. From the **Dashboard Center** accordion columns on the left, click **Dashboard Information**.

:::Paragraph{indent="1"}
The application expands the dashboard information area.
:::

4. Enter information into the fields.

| Field                       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Layout                      | Select **Column** or **Row** to specify the layout orientation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Fit vertical size           | Automatically fits the window height to the screen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Min horizontal size         | Minimum width of the dashboard (in pixels).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Min vertical size           | Minimum height of the dashboard (in pixels).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Name                        | Unique name for the dashboard part. Duplicate names may cause issues.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Description                 | A brief description of the dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Category                    | Select a data category from the dropdown list to assign it to the dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Auto refresh (in minutes)   | Set the interval (in minutes) for automatic data updates. Use the dropdown menu to select a refresh rate between 5 and 60 minutes.<br />On-premise users can disable this setting by performing the following:<br />1. Open the \AppServer\Web.config file with a text editor.<br />2. Go to <font color="#0000ff">&lt;</font><font color="#b22222">add </font><font color="#ff0000">key</font><font color="#0000ff">=</font>"<font color="#0000ff">IsAutoRefreshDisabled</font>" <font color="#ff0000">value</font><font color="#0000ff">=</font>"<font color="#0000ff">false</font>"<font color="#0000ff">/&gt;</font>.<br />3. Change the value from **false** to **true**.<br />4. Save the file. |
| Add to my dashboards        | Makes the dashboard available for your role.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Set as Default to MySelf    | Sets the dashboard as the default on your **Home** tab.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Refresh on Dashboard Select | Refreshes data each time the dashboard loads.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Publish to                  | The roles that this dashboard part is available for. The menu options depend upon your role. You might see only one available role selection if you are in one role, or several role selections if you belong to several roles. See [Assigning a Dashboard to a Role](docId\:gXhuD4TC-pF2lGHuSckyI).                                                                                                                                                                                                                                                                                                                                                                                                  |
| Default for                 | The roles that this dashboard is the default for. The default dashboard automatically appears on the home page for this role. Each role can only have one default dashboard.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Alerts                      | Shows the alerts banner on the dashboard. See [About Alerts](docId\:rMoDUcp0c-QjuSZPGNaVs).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Search                      | Shows the search area in the dashboard. See [Using Search](docId\:X_pckJHiyVYdgx4mj54lb). You can only search for a business object if it is available to your role. The top-level **Search** tab for your role must have the business object name defined for you to be able to search for that business object. By default, the **Search** tab is configured to search for FAQs and announcements.                                                                                                                                                                                                                                                                                                  |

5. Add dashboard parts to the workspace area. You can drag and drop dashboard parts from the columns or you can create your own dashboard parts. See [Using the Dashboard Center](docId\:NAmwiM_AHfHMj7QIlA1EE).
6. Click **Save**.

## Modifying a Dashboard

:::hint{type="info"}
Only administrators or users with edit permissions can modify dashboards.
:::

1. Go to Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace.

:::Paragraph{indent="1"}
The application displays a list of dashboards.
:::

2. Click **edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} icon next to the dashboard.

:::Paragraph{indent="1"}
The application displays the Dashboard Center.
:::

3. In the **Dashboard Center** modify the required information from the list such as dashboard information, charts, tiles, tables, special parts, tree parts, or pivot tables to make changes to these specific parts.
   - **Dashboard Information** - Modify the dashboard name, description, category, and set the auto-refresh timer to a minimum of 5 minutes and a maximum of 60 minutes.
   - **Charts** -Add, delete, or edit charts. Click the **edit** icon and adjust settings in the **Standard**, **Drill-down**, or **Advanced** tabs, including chart type, grouping, or sorting order. Click **Save** to apply changes.
   - **Tiles** - Add, delete, or modify tile types. Click the **edit** icon, update the tile name or type, and click **Save**.
   - **Tables** - Add, delete, or modify tables. Click the edit icon, update the table, and click **Save**.
   - **Special Parts** - Add, delete, or modify titles, descriptions, icons, toolbar buttons, list item displays, and command execution for improved functionality.
   - **Tree Parts** - Add, delete, or customize the tree structure by defining tree title, node names, relationships, and object fields.
   - **Pivot Table** - Add, delete, or modify custom reports to display cubicle data by building. Preview the changes before saving.
4. Drag and drop parts to rearrange them.
5. Click **Save**.

## Adding or Removing Columns or Rows to or from a Dashboard

### Add a Column or Row

1. Go to Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace.

:::Paragraph{indent="1"}
The application displays a list of dashboards.
:::

2. Click **edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} next to the dashboard.

:::Paragraph{indent="1"}
The application displays the Dashboard Center.
:::

3. To add a column to the dashboard, do the following:

:::Paragraph{indent="1"}
a. Under the **Dashboard Information** heading, ensure that the **Layout** field is set to **Column**.
:::

:::Paragraph{indent="1"}
b. Click **add&#x20;**:inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/iA42m8Y4Twd8e6-_7vsEE_add-icon.png" alt caption width="15" height="15"}**&#x20;column**.
:::

:::Paragraph{indent="1"}
The application adds a new column to the right of any existing columns. The dashboard can have a maximum of 5 columns.
:::

4. To add a row to the dashboard, do the following:

:::Paragraph{indent="1"}
a. Under the **Dashboard Information** heading, ensure that the **Layout** field is set to **Row**.
:::

:::Paragraph{indent="1"}
b. Click **add &#x20;**:inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/iA42m8Y4Twd8e6-_7vsEE_add-icon.png" alt caption width="15" height="15"}**&#x20; row**.
:::

:::Paragraph{indent="1"}
The application displays a new row at the bottom of the dashboard.
:::

:::hint{type="info" indent="1"}
If you change the layout from column to row or from row to column, you must resize the dashboard parts that are displayed to fit within your layout.
:::

5. Click **Save**.

### Remove a Column or Row

1. From the Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace. The application displays a list of dashboards.
2. Click **edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} next to the dashboard.

:::Paragraph{indent="1"}
The application displays the Dashboard Center.
:::

3. Remove all components (tables, graphs, etc,) from the column or row you want to delete:
   - Click **remove** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/e3835pzSqQpu91Q1nXqBc_deleteblue2.png" alt caption size="10" width="16" height="16"} at the top right of each component to remove it from the column or row.
4. Click **remove** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/e3835pzSqQpu91Q1nXqBc_deleteblue2.png" alt caption size="10" width="16" height="16"} to the right of **Add Dashboard Objects To This Column/Row** to remove the column or row.
5. Click **Yes** in the **Delete dashboard part** dialog.
6. Click **Save**.

## Resizing a Dashboard Part

The size of the dashboard parts are defined globally. However, if you resize the parts, you override the default size.

1. From the Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace.

:::Paragraph{indent="1"}
The application displays a list of dashboards.
:::

2. Click **edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} next to the dashboard.

:::Paragraph{indent="1"}
The application displays the Dashboard Center.
:::

3. From the **Dashboard Center**, click **Resize**.

:::Paragraph{indent="1"}
The application displays colored lines at the outer edges of each dashboard part on the right side.
:::

4. Hover your mouse over the lines until you see the resize handles, then click and grab the handles to resize the parts.
5. Click **Save**.

## Deleting a Dashboard

You can delete a dashboard that you have created.

:::hint{type="info"}
Unless you are an administrator, you can only delete dashboards and dashboard parts that you created. If your role has delete permissions for dashboards, you can delete dashboard parts created by other users.
:::

1. From the Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace. The application displays a list of dashboards.
2. From the right column, click **delete** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/36wp44StYgWRScATebSZs_deleteredx.png" alt caption size="10" width="14" height="13"} corresponding to the dashboard to delete.

:::Paragraph{indent="1"}
The application displays a **Delete Dashboard** confirmation window.
:::

3. Click **Yes**.

:::Paragraph{indent="1"}
The application removes the dashboard from the list.
:::

## Assigning a Dashboard to a Role

Users can create dashboards for themselves, and administrators can create dashboards for any user. Users who have certain permissions can also publish dashboards to specific roles.

When a role has multiple dashboards, the application automatically displays the default dashboard on the home page. Each role can have only one default dashboard. The remaining dashboards are listed under **All Dashboards**.

1. From the Configuration console, click **Build > Charts and Graphs > Dashboards** to open the **Dashboards** workspace.

:::Paragraph{indent="1"}
The application displays a list of dashboards.
:::

2. Click **edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} next to the dashboard.

:::Paragraph{indent="1"}
The application displays the Dashboard Center.
:::

3. From the Dashboard Center accordion columns, select **Dashboard Information**.

:::Paragraph{indent="1"}
The application displays general information about the dashboard.
:::

4. In the **Publish to** field, select the roles to publish this dashboard to. If you cannot select any roles, you do not have permission to publish the dashboard.
5. Click **Save**.

:::hint{type="info"}
Each role can have multiple default dashboards assigned. The system selects the first dashboard in alphabetical order as the default.
:::
