Embedding Dashboards and Widgets

This article is about getting started with embedded Sisense dashboards. If you’re new to Sisense, check out our embedded analytics solutions.

You can embed Sisense dashboards and widgets in non-Sisense environments, such as in your own websites or applications, by concatenating parameters to the URL of your dashboard or widget.

Note: You can embed a dashboard, or a widget, or the whole Sisense application. Embedding only the Data, Pulse or Admin tabs is not supported.

Sisense offers two embed modes:

Edit mode: Users can edit the dashboard /widgets directly from the non-Sisense environment. Note that editing is allowed only for users who have permissions to edit Sisense in the regular Sisense environment. Viewer users will not be able to edit the dashboards and widgets, even in edit mode.
View mode: All users can view the dashboards and widgets from the host environment. In addition, Designer users can resize dashboards, and they can also perform the actions available through the button of the dashboard/widget, such as duplicating and downloading dashboards, and renaming and deleting widgets.

Breaking Changes: From version 8.1, Designers will not be able to make any changes in view mode (including the changes listed above). In order for designers to make any changes to dashboards and widgets, the host environment will have to be configured to edit mode.

To embed:

Copy the URL of the dashboard. For a widget, click to open the widget in the Widget Designer, and copy the URL of the widget.
Add one of the following to the URL:
- To embed in view-only mode: add the ?embed=true parameter to the URL of the dashboard or widget.
- To embed in edit mode: add the ?embed=true&edit=true parameters to the URL of the dashboard or widget.

You can use this URL to embed the dashboard in an iFrame, for example:

Dashboard within a Folder

If your dashboard is within a folder, then first delete ?folder= and everything that follows, before adding ?embed=true.

This will open the dashboard without the surrounding Sisense environment.

For example:

Dashboard URL for dashboard within folder:

mysite.com/app/main#/dashboards/550952417404b2981a000029?folder=550955a27404b2981a00003b

Embedded URL for dashboard within folder:

http://localhost:8081/app/main#/dashboards/550952417404b2981a000029?embed=true

Embedding Configuration Options

In the edit mode, the dashboard/widget appears by default with the panels opens. You can hide some (or all) panels to prevent users from making changes to these panels.

In the view mode, the dashboard/widget appears by default with the Filters panel open. You can hide this panel, or you can enable all users to view other panels, to see the selections made there.

You do that by adding the following parameters to the URL of the dashboard/widget following the main parameters ?embed=true or ?embed=true&edit=true. All the below parameters are optional.

Parameter	In Dashboards	In Widgets
&h=true / false Example: ?embed=true&h=true	Show/hide the environment header	Show/hide the environment header
&t=true / false Example: ?embed=true&t=true	Show/hide the dashboard toolbar	Show/hide the widget toolbar
&l=true / false Example: ?embed=true&l=true	Show/hide the Navigation Panel to the left	Show/hide the data panel to the left
&r=true / false Example: ?embed=true&r=false	Show/hide the filter panel to the right	Show/hide the filter and design panel to the right

Dashboard panels:

Widget panels:

For example, if you want to hide the Sisense header from the dashboard, you can add the ?embed=true&edit=true&h=false parameters to the URL of the dashboard to hide the header:

mysite.com/app/main#/dashboards/5541dc7a80a4e2181e00011a?embed=true&edit=true&h=false

In this example, the embed=true embeds the dashboard into your environment in the view mode. The edit=true parameter allows the users with the appropriate permissions to edit Sisense in your environment. The h=false parameter hides the Sisense header, allowing you to whitelabel the dashboard.

Authentication in Embedded Dashboards and Widgets

All Sisense dashboards and widgets require authentication. When embedding dashboards and widgets outside of the Sisense environment, usually the use case is to not enforce the Sisense environment authentication, but rather use SSO (Single Sign On) with existing corporate authentication. To read more on configuring Single Sign On in Sisense, click here.