Dashboard settings

To get to a dashboard’s settings:

1. Select Dashboards from the global navigation.

2. Open the dashboard whose settings you’d like to edit.

3. Select Settings from the dashboard sidebar.

The following dashboard settings are available to edit:

Title

The name of the dashboard

Description

An optional short description of the dashboard

Include a description to give dashboard viewers an overview of the dashboard’s purpose and other important information.

URL slug

The part of the web address that points to the dashboard

If kept blank, we auto-generate a URL using the category and title of the dashboard. Changing the dashboard title or the category does not automatically update the URL slug.

Category

The folder where the dashboard is located

You can also use nested categories with the following format: Parent category > Child category Learn more about dashboard categories.

Time zone

Changes the dates and times in the dashboard to use the chosen time zone

Use viewer’s local time zone

Uses the dashboard viewer’s time zone instead of the set dashboard time zone

Cache duration

How long the data on the dashboard is considered up to date

Each chart is cached in our system from the first time the chart is created and saved. The cache duration tells us how long to keep chart data before querying your data source for fresh data. How often this happens depends on your refresh dashboard setting.

If you’d like fresh data very often, you can set the cache duration to a lower time interval. The lowest cache duration you can set is two minutes, but this may severely impact your data source performance. On the other hand, if you’re worried about your data source performance, you can set the cache duration to a higher value to trigger queries less frequently.

Your workspace’s default cache duration is set for all dashboards in your workspace settings. Select Use workspace default to set the dashboard’s cache duration to your workspace default, or deselect to override it.

Learn more about when Atlassian Analytics sends new queries to your data source.

If cache is out of date, refresh dashboard

Specifies when to send new queries to data sources if the dashboard is out of date:

• When dashboard is open in the active tab

• When dashboard is first opened in a tab (it won’t refresh again unless manually refreshed)

• Manually

Depending on the selection, the dashboard will update the charts with whatever exists in the cache at that point. If there are no existing results in the cache, or the cache is expired, then the charts’ queries are sent to the data sources and the charts’ caches will update.

If you select Manually for your refresh dashboard setting, the dashboard will only update when you select Refresh data from the dashboard’s sidebar. This sends new queries if a chart’s cached data is more than two minutes old.

Check cache

How often to check if the dashboard’s data is out of date

Automatically update dashboard when a variable changes

Triggers new queries to request new data every time you change the values of a variable control

Deselect this option if you’d instead like to update multiple controls then apply the changes all at once to send a single set of new queries. You’ll see an Update charts button in the upper right of your dashboard whenever you change a control. Once you’re finished updating your control values, select this button to apply the control changes to your charts.

Deselecting this setting is beneficial for dashboard performance because it prevents new chart queries from triggering every time you make a control selection, for example, in a multi-select “Dropdown” control.

Allow viewers to refresh data

Lets dashboard viewers manually refresh the dashboard with new data

Enable subscriptions

Allows people with access to manage the dashboard to create dashboard subscriptions. Learn more about dashboard subscriptions.