Linking on Grafana Labs

Linking overview

Sat, 04 Apr 2026 12:26:57 +0000

Linking overview

You can use links to navigate between commonly-used dashboards or to connect others to your visualizations. Links let you create shortcuts to other dashboards, panels, and even external websites.

Grafana supports dashboard links, panel links, and data links. Dashboard links are displayed at the top of the dashboard. Panel links are accessible by clicking an icon on the top left corner of the panel.

Which link should you use?

Start by figuring out how you’re currently navigating between dashboards. If you’re often jumping between a set of dashboards and struggling to find the same context in each, links can help optimize your workflow.

The next step is to figure out which link type is right for your workflow. Even though all the link types in Grafana are used to create shortcuts to other dashboards or external websites, they work in different contexts.

If the link relates to most if not all of the panels in the dashboard, use dashboard links.
If you want to drill down into specific panels, use panel links.
If you want to link to an external site, you can use either a dashboard link or a panel link.
If you want to drill down into a specific series, or even a single measurement, use data links.

Controlling time range using the URL

You can control the time range of a panel or dashboard by providing following query parameters in dashboard URL:

from - defines lower limit of the time range, specified in ms epoch
to - defines upper limit of the time range, specified in ms epoch
time and time.window - defines a time range from time-time.window/2 to time+time.window/2. Both params should be specified in ms. For example ?time=1500000000000&time.window=10000 will result in 10s time range from 1499999995000 to 1500000005000

Dashboard links

Sat, 04 Apr 2026 12:26:57 +0000

Dashboard links

When you create a dashboard link, you can include the time range and current template variables to directly jump to the same context in another dashboard. This way, you don’t have to worry whether the person you send the link to is looking at the right data. For other types of links, refer to Data link variables.

Dashboard links can also be used as shortcuts to external systems, such as submitting a GitHub issue with the current dashboard name.

To see an example of dashboard links in action, check out:

Once you’ve added a dashboard link, it appears in the upper right corner of your dashboard.

Add links to dashboards

Add links to other dashboards at the top of your current dashboard.

While viewing the dashboard you want to link, click the gear at the top of the screen to open Dashboard settings.
Click Links and then click Add Dashboard Link or New.
In Type, select dashboards.
Select link options:
- With tags – Enter tags to limit the linked dashboards to only the ones with the tags you enter. Otherwise, Grafana includes links to all other dashboards.
- As dropdown – If you are linking to lots of dashboards, then you probably want to select this option and add an optional title to the dropdown. Otherwise, Grafana displays the dashboard links side by side across the top of your dashboard.
- Time range – Select this option to include the dashboard time range in the link. When the user clicks the link, the linked dashboard opens with the indicated time range already set. Example: https://play.grafana.org/d/000000010/annotations?orgId=1&from=now-3h&to=now
- Variable values – Select this option to include template variables currently used as query parameters in the link. When the user clicks the link, any matching templates in the linked dashboard are set to the values from the link. Here is the variable format: https://${you-domain}/path/to/your/dashboard?var-${template-variable1}=value1&var-${template-variable2}=value2 Example: https://play.grafana.org/d/000000074/alerting?var-app=backend&var-server=backend_01&var-server=backend_03&var-interval=1h
- Open in new tab – Select this option if you want the dashboard link to open in a new tab or window.
Click Add.

Add a URL link to a dashboard

Add a link to a URL at the top of your current dashboard. You can link to any available URL, including dashboards, panels, or external sites. You can even control the time range to ensure the user is zoomed in on the right data in Grafana.

While viewing the dashboard you want to link, click the gear at the top of the screen to open Dashboard settings.
Click Links and then click Add Dashboard Link or New.
In Type, select link.
Select link options:
- Url – Enter the URL you want to link to. Depending on the target, you might want to include field values. Example: https://github.com/grafana/grafana/issues/new?title=Dashboard%3A%20HTTP%20Requests
- Title – Enter the title you want the link to display.
- Tooltip – Enter the tooltip you want the link to display when the user hovers their mouse over it.
- Icon – Choose the icon you want displayed with the link.
- Time range – Select this option to include the dashboard time range in the link. When the user clicks the link, the linked dashboard opens with the indicated time range already set. Example: https://play.grafana.org/d/000000010/annotations?orgId=1&from=now-3h&to=now
  - from - Defines the lower limit of the time range, specified in ms epoch.
  - to - Defines the upper limit of the time range, specified in ms epoch.
  - time and time.window - Define a time range from time-time.window/2 to time+time.window/2. Both params should be specified in ms. For example ?time=1500000000000&time.window=10000 will result in 10s time range from 1499999995000 to 1500000005000.
- Variable values – Select this option to include template variables currently used as query parameters in the link. When the user clicks the link, any matching templates in the linked dashboard are set to the values from the link. Here is the variable format: https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2 Example: https://play.grafana.org/d/000000074/alerting?var-app=backend&var-server=backend_01&var-server=backend_03&var-interval=1h
- Open in new tab – Select this option if you want the dashboard link to open in a new tab or window.
Click Add.

Update a dashboard link

To change or update an existing dashboard link, follow this procedure.

In Dashboard Settings, on the Links tab, click the existing link that you want to edit.
Change the settings and then click Update.

Duplicate a dashboard link

To duplicate an existing dashboard link, click the duplicate icon next to the existing link that you want to duplicate.

Delete a dashboard link

To delete an existing dashboard link, click the trash icon next to the duplicate icon that you want to delete.

Panel links

Sat, 04 Apr 2026 12:26:57 +0000

Panel links

Each panel can have its own set of links that are shown in the upper left corner of the panel. You can link to any available URL, including dashboards, panels, or external sites. You can even control the time range to ensure the user is zoomed in on the right data in Grafana.

Click the icon on the top left corner of a panel to see available panel links.

Add a panel link

Hover your cursor over the panel that you want to add a link to and then press e. Or click the dropdown arrow next to the panel title and then click Edit.
On the Panel tab, scroll down to the Links section.
Expand Links and then click Add link.
Enter a Title. Title is a human-readable label for the link that will be displayed in the UI.
Enter the URL you want to link to. You can even add one of the template variables defined in the dashboard. Press Ctrl+Space or Cmd+Space and click in the URL field to see the available variables. By adding template variables to your panel link, the link sends the user to the right context, with the relevant variables already set. You can also use time variables:
- from - Defines the lower limit of the time range, specified in ms epoch.
- to - Defines the upper limit of the time range, specified in ms epoch.
- time and time.window - Define a time range from time-time.window/2 to time+time.window/2. Both params should be specified in ms. For example ?time=1500000000000&time.window=10000 will result in 10s time range from 1499999995000 to 1500000005000.
If you want the link to open in a new tab, then select Open in a new tab.
Click Save to save changes and close the window.
Click Save in the upper right to save your changes to the dashboard.

Update a panel link

On the Panel tab, find the link that you want to make changes to.
Click the Edit (pencil) icon to open the Edit link window.
Make any necessary changes.
Click Save to save changes and close the window.
Click Save in the upper right to save your changes to the dashboard.

Delete a panel link

On the Panel tab, find the link that you want to delete.
Click the X icon next to the link you want to delete.
Click Save in the upper right to save your changes to the dashboard.

URL variables

Sat, 04 Apr 2026 12:26:57 +0000

Data link variables

You can use variables in data links to refer to series fields, labels, and values. For more information about data links, refer to Data links.

To see a list of available variables, type $ in the data link URL field to see a list of variables that you can use.

Note: These variables changed in 6.4 so if you have an older version of Grafana, then use the version picker to select docs for an older version of Grafana.

You can also use template variables in your data links URLs, refer to Templates and variables for more information on template variables.

Time range panel variables

These variables allow you to include the current time range in the data link URL.

__url_time_range - current dashboard’s time range (i.e. ?from=now-6h&to=now)
$__from and $__to - For more information, refer to Global variables.

Series variables

Series specific variables are available under __series namespace:

__series.name - series name to the URL

Field variables

Field-specific variables are available under __field namespace:

__field.name - the name of the field
__field.labels.<LABEL> - label’s value to the URL. If your label contains dots, then use __field.labels["<LABEL>"] syntax.

Value variables

Value-specific variables are available under __value namespace:

__value.time - value’s timestamp (Unix ms epoch) to the URL (i.e. ?time=1560268814105)
__value.raw - raw value
__value.numeric - numeric representation of a value
__value.text - text representation of a value
__value.calc - calculation name if the value is result of calculation

Template variables

When linking to another dashboard that uses template variables, select variable values for whoever clicks the link.

${myvar:queryparams} - where myvar is a name of the template variable that matches one in the current dashboard that you want to use.

If you want to add all of the current dashboard’s variables to the URL, then use __all_variables.

Data links

Sat, 04 Apr 2026 12:26:57 +0000

Data links

Data links allow you to provide more granular context to your links. You can create links that include the series name or even the value under the cursor. For example, if your visualization showed four servers, you could add a data link to one or two of them.

The link itself is accessible in different ways depending on the visualization. For the Graph you need to click on a data point or line, for a panel like Stat, Gauge, or Bar Gauge you can click anywhere on the visualization to open the context menu.

You can use variables in data links to send people to a detailed dashboard with preserved data filters. For example, you could use variables to specify a time range, series, and variable selection. For more information, refer to Data link variables.

Typeahead suggestions

When creating or updating a data link, press Cmd+Space or Ctrl+Space on your keyboard to open the typeahead suggestions to more easily add variables to your URL.

Add a data link

Hover your cursor over the panel that you want to add a link to and then press e. Or click the dropdown arrow next to the panel title and then click Edit.
On the Field tab, scroll down to the Data links section.
Expand Data links and then click Add link.
Enter a Title. Title is a human-readable label for the link that will be displayed in the UI.
Enter the URL you want to link to.

You can even add one of the template variables defined in the dashboard. Click in the URL field and then type $ or press Ctrl+Space or Cmd+Space to see a list of available variables. By adding template variables to your panel link, the link sends the user to the right context, with the relevant variables already set. For more information, refer to Data link variables.
If you want the link to open in a new tab, then select Open in a new tab.
Click Save to save changes and close the window.
Click Save in the upper right to save your changes to the dashboard.

Update a data link

On the Field tab, find the link that you want to make changes to.
Click the Edit (pencil) icon to open the Edit link window.
Make any necessary changes.
Click Save to save changes and close the window.
Click Save in the upper right to save your changes to the dashboard.

Delete a data link

On the Field tab, find the link that you want to delete.
Click the X icon next to the link you want to delete.
Click Save in the upper right to save your changes to the dashboard.