Dashboard component events

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read
  • Select event handlers to configure the actions (events) provided with the dashboard component.

    The Events tab shows the events used by the dashboard component. To view the available events, select + Add event mapping. Select the event in the list to add one or more event handlers.

    Event handlers

    Event handlers work with data resources to link the dashboard actions to the data you want to display to your users. Select the event in the list to add one or more event handlers.

    Event descriptions

    Event Description
    Navigate to dashboard overview page Dispatched when the dashboard is closed and redirects to the dashboard library. You can customize this behavior by changing the route and title in the Redirect to dashboard list client script. To open client scripts, select the <> icon in the page's side bar.
    * @param {params} params
    * @param {api} params.api
    * @param {any} params.event
    * @param {any} params.imports
    * @param {ApiHelpers} params.helpers
    */
    function handler({api}) {
        api.emit('SCREEN_STATUS_CHANGED', {status: 'closed'});
        api.emit('NAV_ITEM_SELECTED', {
            route: 'dashboard-library',
            title: 'Dashboard Library',
        });
    }
    Dashboard Widget Clicked
    Add this event handler if you want to override the default drilldown with custom behavior when a visualization on the dashboard is clicked. It uses the Dashboard Widget Clicked client script. To add a custom drilldown:
    1. Set the defaultDrilldowns property to false.
    2. Add the Dashboard Widget Clicked event handler.
    3. Open the Dashboard Widget Clicked client script. To open client scripts, select the <> icon in the page's side bar.
    4. Locate the code api.emit('NAV_ITEM_SELECTED', payload); and update payload to align with your custom redirect logic.
    Dashboard Changed
    Enables multiple dashboards and lists to be open in separate workspace primary tabs by distinguishing between direct selection and CMD + click navigation. Supports tab grouping. Parameters:
    • dashboardSysId
    • currentTabSysId
    • filter (filter sys ID if applicable)
    • passiveNavigation: true for CMD + click, false for direct selection
    Example:
    ('DASHBOARD_CHANGED',
    ,{
        params: {
            dashboardSysId: 123,
            currentTabSysId: 234,
            filter: 456,
        }
        passiveNavigation: true,
    })