Hyperlinks enable Klipfolio dashboard users to navigate within their dashboard and to external websites by clicking a specially formatted field in a Klip.
A dashboard hyperlink is used to add, reuse, or replace a dashboard in Klipfolio and to optionally pass in parameters to control the data displayed on that dashboard. To navigate to a dashboard by clicking a hyperlink, a dashboard user must have the Manage dashboard visibility permission. For a description of access permissions, see User roles and access permissions.
The following Klip components support the addition of hyperlinks:
Watch this video for an example of how to set up dashboard hyperlinks.
This article includes the following sections:
Adding a hyperlink to a Klip
To add a hyperlink to a Klip:
- Select the subcomponent that will contain the hyperlink, for example a Table column.
- Inline Frame, Map and News Klips support hyperlinks by default. For Label, Table and Value Pair Klips, go to the Properties tab and:
- Set Format as to Hyperlink.
- To have the hyperlink open in the current browser tab, check Open link in current browser tab. Otherwise the hyperlink, when clicked, will open a new browser tab.
- Optionally set Show Label for the label (this is what the user will see and click). Alternatively, the label can be set in the formula as described in the next step. If a label is set in both the formula and by Show Label, the Show Label value will be displayed.
- Go to the Data tab and type your hyperlink.
Examples:
https://www.klipfolio.com
#tab-0123456789abcdef0123456789abcdef
To set a label in the formula, prefix the hyperlink with "label|", for example:
label|#tab-0123456789abcdef0123456789abcdef
Using hyperlinks to add, reuse, or replace a dashboard
You can use hyperlinks to navigate your dashboard by adding, reusing, or replacing dashboards.
Note: Dashboards were formerly called tabs. The term tab remains in use for parameters such as the ones listed below.
Creating a dashboard hyperlink
There are three types of dashboard hyperlinks: tab-, tab-reuse-, and tab-replace-. The following table describes the action for each type, depending on whether the dashboard currently exists in your Klipfolio account:
Dashboard hyperlink | If a dashboard exists in Klipfolio | If a dashboard does not exist in Klipfolio |
tab- | Goes to a specified dashboard in Klipfolio. If a parameter is passed in, a new dashboard will be added each time the parameter changes. | Adds a specified dashboard in Klipfolio. If a parameter is passed in, a new dashboard will be added each time the parameter changes. |
tab-reuse- | Goes to a specified dashboard in Klipfolio. If a parameter is passed in, this dashboard will be reused each time the parameter changes. | Adds a specified dashboard in Klipfolio. If a parameter is passed in, this dashboard will be reused each time the parameter changes. |
tab-replace- | Replaces the current dashboard with a specified dashboard in Klipfolio. If a parameter is passed in, this dashboard will be reused each time the parameter changes. | Replaces the current dashboard with a specified dashboard in Klipfolio. If a parameter is passed in, this dashboard will be reused each time the parameter changes. |
The following example describes how to create a Table Klip column of hyperlinks that redirects the user to another dashboard when clicked.
To create a dashboard hyperlink:
- The dashboard ID in the hyperlink identifies the dashboard to be displayed when the hyperlink is clicked. Note that this dashboard must be shared in order to be displayed on a dashboard. Find the dashboard ID (to be used in step 4) using one of the following methods:
- Click Dashboards in the left navigation bar and select the dashboard to be hyperlinked or
- Select the dashboard in Klipfolio, and beside the dashboard name, click the 3-dot menu and select About this dashboard.
- In the Klip Editor, add a column to the table.
- Under the Properties tab,
- Set Format as to Hyperlink.
- To have the hyperlink open in the current browser tab, check Open link in current browser tab. Otherwise the hyperlink, when clicked, will open a new browser tab.
- Under the Data tab, type one of the following (within quotes):
"#tab-<dashboard ID>"
, for example,"#tab-0123456789abcdef0123456789abcdef"
"#tab-reuse-<dashboard ID>"
, for example,"#tab-reuse-0123456789abcdef0123456789abcdef"
"#tab-replace-<dashboard ID>"
, for example,"#tab-replace-0123456789abcdef0123456789abcdef"
CONCAT ("label","|","#tab-reuse-<tab ID>")
Setting dashboard hyperlink parameters
Watch this video to see how to set hyperlinks to link to external websites and to link internally within your Klipfolio account using hyperlinks with variables.
If a hyperlinked dashboard has Klips that respond to variables, you can add one or more parameters to the hyperlink to dynamically pass data to the hyperlinked dashboard, using the syntax:
param:var1=value1
where:
param
is a keywordvar1
is a Klipfolio dashboard variable used by a Klip on the hyperlinked dashboard.value1
is the value assigned tovar1
Note: Dashboard hyperlink parameters are effectively dashboard-scoped variables, but also override variables set by User Input Controls with scope set to "All dashboards".
The first parameter in the hyperlink must be prefixed with a question mark (?
) and subsequent parameters must be prefixed with an ampersand (&
).
?param:var1=value1¶m:var2=value2¶m:var3=value3
To add a parameter to the hyperlink, use the CONCAT function to build the expression. For example, to build the following hyperlink,
hyperlinkName|#tab-reuse-0123456789abcdef0123456789abcdef¶m:var1=value1
which will pass in var1
when tab ID 0123456789abcdef0123456789abcdef
is opened:
- In the formula editor, wrap the CONCAT function around the hyperlink:
CONCAT("hyperlinkName|#tab-reuse-0123456789abcdef0123456789abcdef")
- Append
"?param:var1=" (without the quotes)
to the hyperlink. Insert a second parameter (for example,value1
) into your CONCAT formula to specify the value to be assigned tovar1
.value1
can be another variable or hard-coded or come from one of your data sources.
CONCAT("hyperlinkName|#tab-reuse-0123456789abcdef0123456789abcdef?param:var1=",value1)
If value1
= 5, this CONCAT evaluates to
hyperlinkName|#tab-reuse-0123456789abcdef0123456789abcdef?param:var1=5
This step describes how to add a single parameter. If multiple parameters are required, repeat these steps for each parameter, using "?param:"
for subsequent parameters. For example,
hyperlinkName|#tab-reuse-0123456789abcdef0123456789abcdef?param:var1=value1¶m:var2=value2¶m:var3=value3
Any Klips on this tab with formulas that use the var1
variable will use the value assigned to var1
.