Dashboard Navigator

Designed for organizations managing multiple dashboards across departments, regions, or business units, Dashboard Navigator allows end users to move between dashboards without breaking context or losing their current filter state and keeping the experience fluid and uninterrupted. Dashboard designers can organize dashboards into logical groups with one or two levels of hierarchy, apply custom styling, and collapse the native Sisense sidebar entirely, resulting in a cleaner, more polished interface. Whether you're building an internal analytics portal or a customer-facing embedded deployment, Dashboard Navigator transforms complex dashboard ecosystems into an intuitive, seamless experience.

The Dashboard Navigator plugin can be installed by an Admin, following the directions in Installing QBeeQ Plugins.

Operating system and version support:

Creating a Dashboard Navigator widget generally involves:

The Layout section controls the structure and display type of the navigation widget.

Each group has the following fields, available in both single and double layer.

Target dashboards are configured using the dashboard picker, accessible from the Target Dashboard field on each group or tab.

The dashboard picker modal displays all dashboards you have access to, sorted alphabetically. Type any part of a dashboard name to filter the list in real time. The search is case-insensitive and matches partial names. If no dashboards match your search, a "No results" message is shown.

A single-layer navigator allows linear navigation between dashboards. Each group maps to one destination dashboard. To create a single-layer Dashboard Navigator widget:

A double-layer navigator adds a second level of navigation. Groups appear as the top layer; clicking a group reveals its tabs in a row below. To create a double-layer Dashboard Navigator widget:

Applies to the top-level group controls. Available in both single and double layer.

Applies to the second-level tab controls. Only visible when the double layer is enabled.

The Dashboard Navigator can open target dashboards in an embedded view, keeping the viewer within the current page context rather than navigating away. This is useful for avoiding the display of the Sisense native navigation panel, or for hosting dashboards in external environments.

"Dashboard not found" warning on a target dashboard field

The plugin saved a dashboard ID that it can no longer resolve to a name. This typically happens when:

Click the pencil icon next to the raw ID to open the dashboard picker and select a valid replacement. If the original dashboard still exists, search for it by name to confirm it appears in the list. If it does not appear, the dashboard may have been deleted, or you may not have access to it.

A group or tab doesn't appear in the widget

The plugin only renders a navigation element if it has both a Title and a Target dashboard set. If either field is empty, the element is silently skipped.

Open the design panel and verify that every group and tab intended to be visible has both a title and a target dashboard configured.

Clicking a navigation element (button, link, or tab) and nothing happens

This usually means the target dashboard field is empty for that element. It can also happen if the saved dashboard ID is invalid and runtime navigation fails silently.

In the design panel, check the target dashboard field for the affected group or tab. If it shows "Select dashboard…" or a ⚠ warning, reconfigure it using the dashboard picker.

Filters are not being applied on navigation

Filter pass-through requires that the filter names configured in the Filters field match exactly on both the source dashboard and the target dashboard. Common causes of mismatch include:

To resolve:

Circular navigation (widget navigates back to the same dashboard)

The plugin does not detect or prevent circular navigation. If Dashboard A has a navigator pointing to Dashboard B, and Dashboard B has a navigator pointing back to Dashboard A, a viewer can navigate in circles indefinitely.

Review your navigation structure and ensure that it flows in one direction only, or that dashboards intended as destinations do not link back to their referrers. If you need a dashboard to appear as a destination in multiple navigators, consider whether a "home" or "back" link is more appropriate than a full circular route.

The same dashboard is used as a target more than once in the same widget

Navigation behaves unexpectedly, or the active state highlights incorrectly when the same dashboard ID appears on multiple groups or tabs within a single widget.

The plugin uses the dashboard ID to determine which group or tab is currently active. If the same ID appears more than once, the active state logic may match multiple elements simultaneously, leading to unpredictable highlighting.

Do not assign the same dashboard ID to more than one group or tab within a single Dashboard Navigator widget. If you need multiple navigation elements that logically point to the same content, duplicate the target dashboard in Sisense and use each copy's unique ID for the respective element.

The dashboard picker list is empty or fails to load

Opening the dashboard picker modal shows no dashboards, a loading spinner that does not resolve, or an error message.

The picker fetches the dashboard list from the Sisense API (GET /api/v1/dashboards) each time the modal opens. If the request fails or returns no results, it may be due to:

Click the retry option shown in the error state. If the problem persists, refresh the page to renew your Sisense session and try again. If the list loads but your expected dashboard is missing, confirm that your Sisense user account has access to that dashboard.