Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure custom redirection from a dashboard component

If you have created a page in your workspace from the Dashboard page template, you can customize the on-click redirection from the dashboard component on that page. The inline dashboard that this component displays will follow the custom redirection.

Before you begin

You have created a workspace in UI Builder with a page generated from the Dashboard page template. You may also have set the dashboard component in that page to display a dashboard from the library as described in Add a dashboard to a Dashboards page.

Role required: ui_builder_admin

About this task

Important: The procedure described here applies only to dashboards created in the inline editor. For technical dashboards, you configure redirection through a drilldown event for each data visualization. For more information, see Add a drilldown event to a data visualization on a technical dashboard.

Procedure

  1. Open your workspace in UI Builder.

  2. Open the relevant page.

    You will have built this page using the Dashbords page template.

  3. Select the dashboard component.

  4. In the configuration panel, turn off Use default redirections.

Image omitted: db-turnoff-redirections.png
Turning off default redirections.
You have turned off redirections. Clicking on a visualization at runtime does not trigger any actions.
  1. In the events panel, look whether there is a "Dashboard widget clicked" event handler.

  2. If there is no "Dashboard widget clicked" handler, add one.

    1. Select + Add event mapping.

    2. From the list of available events, select Dashboard widget clicked.

Image omitted: db-add-db-widget-clicked-event.png
Selecting the Dashboard widget clicked event.
  1. In the Data and scripts area of the page, under Client scripts, open Dashboard Widget Clicked.
Image omitted: db-dashboard-widget-clicked.png
Opening the Dashboard widget clicked script in the editor.
  1. In the Edit client script pane, find the line api.emit('NAV_ITEM_SELECTED', payload);.

  2. Update the payload to align with your custom redirection logic.

Result

All redirections from data visualizations on that dashboard open your specified target.

Parent Topic:Creating Platform Analytics pages in your own workspace

Related topics

Create a Platform Analytics workspace from App Engine Studio

Add Platform Analytics pages to a configurable workspace

Add a dashboard to a Dashboards page

Dashboard URL parameter delegation

Pass global filters to the dashboard page template

Configure dashboard data broker