Analytics Embedding
Hashboard supports embedding Data Models, Saved Explorations, and Dashboards in external applications via an iframe.
Embedding a resource
To embed a Hashboard resource, add viewMode=embed
to the URL parameters of your Data Model, Saved Exploration, or Dashboard URL and set that URL to be the src
of an iframe
HTML tag.
For instance, if your Saved Exploration URL is:
https://hashboard.com/app/sv/Sgf5dLgMfFeafeDe
then corresponding embedded iframe will be:
<iframe src="https://hashboard.com/app/sv/Sgf5dLgMfFeWVzie?viewMode=embed"></iframe>
When embedded, the Hashboard side navigation bar is replaced with an information bar at the bottom of the iframe. See examples below.
Right now we do not offer complete white labeling. Embeds via Hashboard surface our logo and a button to open the application at the bottom of the frame.
Authentication
Viewers must be logged in to Hashboard in order to see an embedded resource. If the current user is not logged in, they will be prompted to do so via an embedded login flow.
Resource embeds can be combined with Project Invite Links to enable self-service access to your Hashboard project. To do so:
- Enable Project Invite Links on your project, if not already turned on.
- Copy the
projectInviteToken
parameter from your invite link and append it to your embedded URL.
For instance, if your project invite link is:
https://hashboard.com/app?projectInviteToken=p-Ip2Lw8ep6XafEzSo_NF
and your Saved Exploration URL is:
https://hashboard.com/app/sv/Sgf5dLgMfFeafeDe
Then your self-service embed URL would be:
https://hashboard.com/app/sv/Sgf5dLgMfFeWVzie?viewMode=embed&projectInviteToken=p-Ip2Lw8ep6XafEzSo_NF
Embedded resources are also compatible with Get Access Domains. If enabled, any user with an email address from your organization's domain will be able to create a Hashboard account via the embedded resource.