# Maintaining Dashboards

UCP 14 has been updated to include new functionality called dashboards. Dashboards are collections of widgets in different configurations.

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A30%3A46.png?version=1&modificationDate=1489512646000&api=v2&effects=border-simple,shadow-kn)</span><span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A29%3A32.png?version=1&modificationDate=1489512572000&api=v2&effects=border-simple,shadow-kn)</span>

Dashboards allow users to customize their User Control Panel experience

<div data-hasbody="false" data-headerelements="H1,H2,H3,H4,H5,H6,H7" data-macro-name="toc" id="bkmrk-adding-a-dashboard-d">- <span class="toc-item-body" data-outline="1">[Adding a dashboard](https://wiki.freepbx.org/display/FPG/UCP+Dashboards#UCPDashboards-Addingadashboard)</span>
- <span class="toc-item-body" data-outline="2">[Deleting a dashboard](https://wiki.freepbx.org/display/FPG/UCP+Dashboards#UCPDashboards-Deletingadashboard)</span>
- <span class="toc-item-body" data-outline="3">[Renaming a dashboard](https://wiki.freepbx.org/display/FPG/UCP+Dashboards#UCPDashboards-Renamingadashboard)</span>
- <span class="toc-item-body" data-outline="4">[Reordering a dashboard](https://wiki.freepbx.org/display/FPG/UCP+Dashboards#UCPDashboards-Reorderingadashboard)</span>
- <span class="toc-item-body" data-outline="5">[Locking a dashboard](https://wiki.freepbx.org/display/FPG/UCP+Dashboards#UCPDashboards-Lockingadashboard)</span>

</div>## Adding a dashboard

To add a new dashboard look for the ![(plus)](https://wiki.freepbx.org/s/en_US/7702/c32f84c806260a834c2e109e904a2d8ee4f8e175/_/images/icons/emoticons/add.svg) symbol in the upper right hand side of UCP. Click this icon

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A32%3A49.png?version=1&modificationDate=1489512769000&api=v2&effects=border-simple,shadow-kn)</span>

Now give your dashboard a name and click "Create Dashboard"

<span class="confluence-embedded-file-wrapper confluence-embedded-manual-size">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A33%3A28.png?version=1&modificationDate=1489512808000&api=v2&effects=border-simple,shadow-kn)</span>

Your new dashboard will be created. If you have not previously added any dashboards you will be placed into the dashboard you just created

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A34%3A28.png?version=1&modificationDate=1489512868000&api=v2&effects=border-simple,shadow-kn)</span>

To add widgets to this dashboard please see [UCP Widgets](https://wiki.freepbx.org/display/FPG/UCP+Widgets)

## Deleting a dashboard

To delete a dashboard click the (X) symbol in the dashboard tab

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A36%3A31.png?version=1&modificationDate=1489512992000&api=v2&effects=border-simple,shadow-kn)</span>

A confirmation prompt will ask you to confirm

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A37%3A18.png?version=1&modificationDate=1489513038000&api=v2&effects=border-simple,shadow-kn)</span>

If you are actively viewing the dashboard you have just deleted you will be warned appropriately

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A37%3A58.png?version=1&modificationDate=1489513078000&api=v2&effects=border-simple,shadow-kn)</span>

Simply Add a new dashboard to continue

## Renaming a dashboard

To rename a dashboard click the (Pencil) symbol in the dashboard tab

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A36%3A36.png?version=1&modificationDate=1489512996000&api=v2&effects=border-simple,shadow-kn)</span>

Change the name of the dashboard and click "Edit Dashboard"

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A39%3A21.png?version=1&modificationDate=1489513162000&api=v2&effects=border-simple,shadow-kn)</span>

The name will be updated in UCP

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A39%3A54.png?version=1&modificationDate=1489513194000&api=v2&effects=border-simple,shadow-kn)</span>

## Reordering a dashboard

Dashboard Tabs can also be reordered.

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A41%3A12.png?version=1&modificationDate=1489513273000&api=v2&effects=border-simple,shadow-kn)</span>

Simply click and drag any dashboard tab into a new position

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A42%3A17.png?version=1&modificationDate=1489513337000&api=v2&effects=border-simple,shadow-kn)</span>

After letting go of the mouse button the configuration order will be instantly saved

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A42%3A31.png?version=1&modificationDate=1489513351000&api=v2&effects=border-simple,shadow-kn)</span>

## Locking a dashboard

Locking a dashboard will lock the position and size of all widgets within.

To lock a dashboard click the (lock) icon in the Dashboard tab

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A36%3A36.png?version=1&modificationDate=1489512996000&api=v2&effects=border-simple,shadow-kn)</span>

When a dashboard has been locked it will look like this:

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A44%3A30.png?version=1&modificationDate=1489513471000&api=v2&effects=border-simple,shadow-kn)</span>

To unlock said dashboard just click the lock icon again:

<span class="confluence-embedded-file-wrapper">![](https://wiki.freepbx.org/download/attachments/74319426/image2017-3-14%2014%3A36%3A36.png?version=1&modificationDate=1489512996000&api=v2&effects=border-simple,shadow-kn)</span>