.. _dashboards:


Introduction to Dashboards 
-------------------------------

.. _21.3|EKB-12577:
.. _22.2|EKB-13746:
.. _23.1|VOSS-1135:
.. _23.3|VOSS-1331:



Dashboard Library 
.....................

On the Insights Dashboard system user interface, you can access the dashboards library via the **Main Menu** 
|main-menu-icon| (hamburger icon). This panel displays all custom and default (VOSS reference) dashboards, 
reports, in folders and sub-folders. 

To expand or collapse the entire tree in the panel, click the **Expand Tree** icon at the top of the panel.

.. image:: /src/images/insights-dashboard-expand-tree.png



.. rubric:: Related Topics 

* 
  .. raw:: latex
  
     *Introduction* in the Dashboards Administration Guide.

  .. raw:: html

     <a href="introduction.html">Introduction</a>

* 
  .. raw:: latex
  
     *VOSS Reference Dashboards* in the Dashboards Administration Guide.

  .. raw:: html

     <a href="default-dashboards.html">VOSS Reference Dashboards</a>

*
  .. raw:: latex
  
     *Custom Dashboards* in the Dashboards Administration Guide.

  .. raw:: html

     <a href="custom-dashboards.html">Custom Dashboards</a>

*
  .. raw:: latex
  
     *Working with Dashboards* in the Dashboards Administration Guide.

  .. raw:: html

     <a href="working-with-dashboards.html">Working with Dashboards</a>

*
  .. raw:: latex
  
     *Access Controls* in the Dashboards Administration Guide.

  .. raw:: html

     <a href="access-controls.html">Access Controls</a>

*
  .. raw:: latex
  
     *Reports* in the Dashboards Administration Guide.

  .. raw:: html

     <a href="reports.html">Reports</a> 


.. _add-new-custom-dashboard:

Add a New Custom Dashboard  
..............................

To add a new, custom dashboard from the dashboard library panel, click the **Add Dashboard** icon at the top of the 
panel. This opens a new page where you can add details for your new, custom dashboard.  

Now you will need to create resource definitions and widgets to use in your dashboard.

.. note:: 

   To make a custom dashboard based on a default dashboard, you can make a copy (clone) of one of the 
   default dashboards, then modify the clone and save it as a new, custom dashboard.  


.. image:: /src/images/insights-dashboard-add-dashboard.png 






Add or Remove Dashboard Folders
.................................

Dashboards are organized initially in alphabetical order. When creating dashboards, you can organize these 
into folders that expand out into trees based on the order you define. 

To add or remove folders in the tree, click the **Folders** icon at the top of the dashboard library panel. When 
removing a folder, first select the folder in the tree.

You can drag and drop a sub-folder into the relevant top-level folder, or drag the 
relevant dashboard into a folder. 

.. note:: 

   Dashboards with the same name can exist in different folders. The names of dashboards in 
   the same folder must be unique.


.. image:: /src/images/insights-dash-folders.png 






.. |main-menu-icon| image:: /src/images/analytics-main-menu-icon.png
.. |analytics-global-filtering| image:: /src/images/analytics-global-filtering.png
.. |analytics-global-filtering-save-filters| image:: /src/images/analytics-global-filtering-save-filters.png
.. |insights-loading-animation| image:: /src/images/insights-loading-animation.png