# Manage dashboards

After you create a dashboard, other actions become available. These actions require additional user permissions.

{% hint style="info" %}
Administrators with the **Dashboards** permission can access the [**Dashboards** page](https://app.gitbook.com/s/vQCmtGTR7MsjcI62Vdki/dashboards-administration), where they can manage all the dashboards in your organization’s Phocas site.
{% endhint %}

## Edit a dashboard

{% hint style="info" %}
User permissions: **Save Dashboards** to edit your own dashboards; **Manage Dashboards** to edit dashboards shared with you.
{% endhint %}

There are several ways to change the look and feel of a dashboard. If you create a dashboard, you customize it to suit your needs at the time, but you can come back to make changes later. You can make changes at the dashboard, line, and widget levels. If you are viewing a shared dashboard, some of these customization options might be unavailable.

To prevent accidental changes, especially when viewing dashboards on mobile devices, dashboards are locked. To put your dashboard into edit mode, click the **Unlock and edit** button in the top-right corner.

<figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FVFibCDp8agOpzuFY6zey%2FDashboardLock.gif?alt=media&#x26;token=cdd6310f-d752-4f39-bfd4-ac269a893e80" alt=""><figcaption></figcaption></figure>

### Edit a dashboard's name, description, or owner

You might want to change the name or description of one of your dashboards or transfer the ownership so that another user can manage it. Changing the owner is especially important if you leave the business because if your Phocas account is deleted, the dashboards you created will no longer be available to other users.

You can quickly edit a dashboard's name, description, and owner from your homepage. Locate the dashboard and click its menu button, then click **Edit**. Make your changes and click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-f81e0c12827529151c5ca3e82e29486ee9014d6f%2F3504013462.png?alt=media" alt="image-20240520-221240.png" width="563"><figcaption></figcaption></figure></div>

You can also edit these details from within the dashboard. In the dashboard toolbar, click the **Share** button, edit the name, and click **Save**.

### Change the way widgets display in a line

In edit mode, hover over the line and click the **Edit** button, then on the **Line** screen, select one of these **Display** options:

* **Stack**: Stack widgets vertically when they will not fit on a line horizontally.
* **Equal width**: Set all widgets to the same width, filling the line and adjusting to the browser window's size. This is useful when a dashboard is going to be viewed using different screens and devices. The minimum widget width is 200 pixels, after which the line will scroll horizontally. The height of all widgets can be adjusted by clicking and dragging from the bottom of any of the widgets in the line. In the image below, three different-sized widgets have been automatically resized to be of equal width.

  <div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-84f5d09088d8ed40dbc0f8db4a9bb088ef56e8b5%2F618297?alt=media" alt="" width="224"><figcaption></figcaption></figure></div>
* **Horizontal scroll**: Allow the widgets to take up as much space as they need, next to each other on the line. Users must scroll to see them.
* **Flex**: Allow the widgets to be resized (see below). This option is also responsive, for different window sizes or devices.

### Show when the widget was last updated

If you have a dashboard that updates frequently, you can add details of exactly when a widget was updated. This is particularly useful on dashboards that contain widgets from multiple sources.

Hover over a widget and click the **Edit** button, then on the **Widget** screen, add the **\[updateDelta]** placeholder in the **Description** box and click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-ae3816d87fc8180284a777e636b52e33990aa5ce%2F44925057.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

### Rearrange widgets <a href="#rearrange-widgets" id="rearrange-widgets"></a>

Click the widget and drag the toolbar to a new position on the dashboard.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-803c7042ef998ee83460bee2009619307a380055%2F616223?alt=media" alt="" width="224"><figcaption></figcaption></figure></div>

### Resize widgets <a href="#resize-widgets" id="resize-widgets"></a>

To temporarily minimize the widget, hover over the widget and click the **Minimize** button.

If the **Flex** option is enabled in the line settings (above), you can permanently change the widget's size: Click and drag the **Re-size** button in the bottom right corner of the widget. The size appears in pixels as you drag.

### Switch widget filters on or off <a href="#switch-widget-filters-on-or-off" id="switch-widget-filters-on-or-off"></a>

Widget types that can be selected and filtered have the filter option switched on by default. You might want to turn this off, for example, to compare the whole company to just one sales rep, or just one branch. So you might have two identical widgets, one that filters and the other that does not.

Hover over a widget and click the **Edit** button. Then, on the **Widget** screen, select **Is Filterable** > **No** and click **Save**. You can turn the filter back on in the same way.

### Set the filtering order <a href="#set-the-filtering-order" id="set-the-filtering-order"></a>

You can determine whether to apply a dashboard filter before or after an existing widget filter, such as an advanced search filter. The order in which the filter is applied affects the results.

Hover over a widget and click the **Edit** button, then on the **Widget** screen, if the widget has a filter applied, you will see an option to select either **Filter applied first** or **Filter applied last**. Select the required option and click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-b10f42d29ef5acfc13073e6574c02a0f7619822b%2F3041362061.png?alt=media" alt="" width="102"><figcaption></figcaption></figure></div>

For example, the image below shows the different results returned depending on the filter order.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-fb8a6eee7e6eac7823bdb68a00152c58d14ec740%2F3041132767.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

## Apply a theme

Change the color scheme used in the chart widgets, ensuring a consistent look across every widget on the dashboard.

Click the **Theme** button (colored rings), then select the required theme from the list.

To revert to the default theme, select the **None** option.

<figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FZ9Jmt9DZT3GZczD0jCaW%2FDashboardTheme.gif?alt=media&#x26;token=bf461231-064d-4e0f-86ec-16427781f874" alt=""><figcaption></figcaption></figure>

## Link dashboards <a href="#link-dashboards" id="link-dashboards"></a>

You can link dashboards to each other. You select a link within a widget in one dashboard to open in another dashboard. You can also choose to filter the data shown in the second dashboard. Only grid widgets (not charts) can be linked.

You can select the dashboard you want to link to when you create a widget or go back and edit a widget’s configuration. From the **Link To Dashboard** dropdown list, select the dashboard you want to link to and click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2Fgit-blob-87b902987f7dd8f88c842ff8b73f3bc786183f14%2F3153428953.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Each data item in the **Code** column of that widget turns blue, indicating there is an active link.

## Share a dashboard

{% hint style="info" %}
User permissions: Collaboration > Share with Folders and/or Share with Users.
{% endhint %}

Read the [Sharing and folders](https://docs.phocassoftware.com/basics/getting-started/sharing-and-folders) page to learn how sharing works.

There are multiple ways to share your dashboards. Typically, you share a dashboard when you create it. At the bottom of the **New Dashboard** window, select the checkboxes for the required folders and users, then click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FoTFNOL6bEt7DSEISEqRQ%2Fimage.png?alt=media&#x26;token=8b259ade-97e1-4394-b295-8dc67c5c8a0b" alt="" width="313"><figcaption></figcaption></figure></div>

Other ways to share your dashboards are outlined below.

### Share from your homepage

On your homepage, locate the favorite, dashboard, or alert you want to share, then click its menu button and click **Share**. In the **Share** window, select the required users and/or folders, then click **Save**.

<div align="left"><figure><img src="https://900295827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7pj8v25BOyqZTdG5mdD1%2Fuploads%2FlawtVcyoYT0wuwvRu79M%2Fimage.png?alt=media&#x26;token=472846c9-38ce-45e6-8381-b3e5d9305991" alt="" width="375"><figcaption></figcaption></figure></div>

### Stop sharing

You can remove your shared dashboards from one or more users or folders in a similar way to how you shared them. On your homepage, locate the item, click its menu button, and click **Share**. In the **Share** window, click the **X** for the required users and folders, then click **Save**.

## Subscribe to a dashboard

{% hint style="info" %}
User permission: Dashboards > Subscribe
{% endhint %}

Subscribe to dashboards to receive email notifications whenever they're updated. See the [Subscriptions](https://docs.phocassoftware.com/basics/getting-started/subscriptions) page for steps.

## Delete a dashboard

{% hint style="info" %}
User permissions: Save Dashboards
{% endhint %}

You can delete the dashboards that you create (own) in two ways:

* On your homepage, locate the dashboard, click its menu button, and then click **Delete** > **Delete**.
* Open the dashboard, then click the **Delete** (button in the top bar above the widgets) > **Yes**.

You can restore deleted dashboards within 45 days from the **Deleted items** tab on your [homepage](https://docs.phocassoftware.com/basics/getting-started/homepage).

If you have many shared dashboards cluttering your homepage, use the grid filters to remove them from view.
