Linking to Another Page, Story, or External URL

You can add a hyperlink to another story or page, or to an external URL.

Context

You can add a hyperlink to the following places in a chart widget: the chart title, the chart footer, and on the chart datapoints.

However, all the other widgets (including tables) can have only one hyperlink per widget.

Procedure

  1. Select the item that you want to link from.
    Option Action
    Select one of the tiles or items:
    • image
    • pictogram
    • text
    • chart tile
    • chart data point

    Do one of the following:

    • Select Start of the navigation path (More Actions) Next navigation step Add Next navigation step  HyperlinkEnd of the navigation path

    • Right-click within the tile (or on a chart data point) and then select Start of the navigation pathAdd Next navigation step  HyperlinkEnd of the navigation path

    Select a table or a table cell.

    Do one of the following:

    • Select Start of the navigation path (More Actions) Next navigation step Add Next navigation step  HyperlinkEnd of the navigation path.

    • Right-click and then select Start of the navigation pathTable Functions Next navigation step Add Next navigation step  HyperlinkEnd of the navigation path.
  2. In the Hyperlink panel, under Link to, select one of the following options:
    Option Description
    None

    This option is set by default.
    Mobile App URL

    Mobile app URL allows users to link to a specific location inside a native app.

    When you enter a mobile app URL, you have the following optional configurations:

    • Under Mobile App URL, select one or more dimensions from the list that appears, to insert the dimensions into the URL. The dimension will be used as a filter on the destination.

      If you want to pass an ID instead of a description, select a dimension and then select one of the options: Description, ID, or ID and Description.

    • Under Label, enter a label for the URL, or from the list, select a dimension to use as a label. The label will be displayed instead of the full URL.

    You can also choose whether you would like to encode dimension values by selecting or deselecting the Escape special characters in dimension values check box. If this check box is selected, dimension values will be encoded.

    Example

    If the dimension value is called Vancouver/Lower Mainland, the encoded dimension value will be Vancouver%2FLower%20Mainland.
    External URL

    When you enter an external URL, you have the following optional configurations:

    • Under External URL, select one or more dimensions from the list that appears, to insert the dimensions into the URL.

      If you want to pass an ID instead of a description, select a dimension and then select one of the options: Description, ID, or ID and Description.

    • Under Label, enter a label for the URL, or from the list, select a dimension to use as a label. The label will be displayed instead of the full URL.

    If you want the destination page or URL to open in a new browser tab, select the Open in New Tab check box.
    Note
    If the link destination is another page in the same story, the application will switch to the destination page within the same browser window when the hyperlink is followed.

    You can also choose whether you would like to encode dimension values by selecting or deselecting the Escape special characters in dimension values check box. If this check box is selected, dimension values will be encoded.

    Example

    If the dimension value is called Vancouver/Lower Mainland, the encoded dimension value will be Vancouver%2FLower%20Mainland.
    Page
    Select a page to link to:
    • First Page
    • Next Page
    • Previous Page
    • Last Page
    • Specific Page: Choose a page from the list that appears.

    Select Apply selected dimension as a filter, to use selected dimensions as a temporary filter on the destination page.

    Select Cascading Effect, to enable changes you make to the filter to affect all related filters in the same page. For more information, see Story and Page Filters.
    Story

    Select a story from the list, and then select a page in the story to link to.

    If you want the destination page or URL to open in a new browser tab, select the Open in New Tab check box.
    Note
    If the link destination is another page in the same story, the application will switch to the destination page within the same browser window when the hyperlink is followed.

    Select Apply selected dimension as a filter, to use selected dimensions as a temporary story filter in the destination story. To return to the hyperlink's source page and remove the temporary story filter, select the filter and then select Go Back to Previous Page.

    Note

    The Apply selected dimension as a filter option only works when the source and destination stories use the same model.

    Select Cascading Effect, to enable changes you make to the filter to affect all related filters in the same story. For more information, see Story and Page Filters.
    Note

    For the Mobile App URL and External URL options, not all chart types support using dimensions in hyperlinks.

  3. Select Done.

Results

To follow the hyperlink, do one of the following:

Story element How to select hyperlink

Image, pictogram, or text

Select the element that contains the hyperlink and then Ctrl + Click ( Cmd + Click ).

The destination page or URL opens.
Table
There are different ways to get to the hyperlink:

  • Right-click a measure data point and then select Go to Link.

  • Select a data point and then select the link in the title area.

    • From the drop down, either select the link again or switch between showing and hiding the hyperlinks in the table.

    • When the hyperlinks are showing in the table, you can select them instead of selecting the link in the title.
Chart

For a hyperlink to an external URL, select one data point (for example, one bar in a bar chart) and then select the hyperlink.

The dimensions represented by that data point are passed to the destination web page.