Contents
Requirements
Embedding Basics
iFrames and Embed URLs
Full Workbook vs Single Page vs Single Element Embeds
Types of Embeds
User-Backed Embeds
Public
Private
Application
Related Resources
Requirements
- To generate public and User-Backed embeds, you must be an organization Admin.
- Any Sigma user can create a private embed.
Embedding Basics
Workbook embedding allows you to present your analysis outside of Sigma in a controlled and secure manner. To create an embed, you will need to know how to create an embed URL, and you or someone on your team must inject the embed into your non-Sigma application.
iFrames and Embed URLs
iFrames and embed URLs are key to displaying any embedded workbook or workbook page or data element. An iFrame is the type of HTML element that renders the embed in the browser. To tell the iFrame what to render, you will need to pass it an embed URL.
<iframe src="https://app.sigmacomputing.io/<your-organization-url>/workbook/<workbook-id>" />
Embed URL creation varies depending on the embed type you are implementing.
Full Workbook vs Single Page vs Single Element Embeds
Public and User-Backed embed types support full workbook, workbook page, and individual data element embedding. Private embeds only support a full workbook and cannot be used to embed a workbook page or individual data element.
You can use the Workbook Embed modal, found in your workbook's header menu, to create any public and/or application embed. Private embeds are created by adding `?:embed=true` to the workbook's URL.
Workbook Controls in Embeds
Hidden Controls
Controls can be hidden from viewers. To hide one more controls, create a new hidden page in the workbook. Housing your controls here will hide them from anyone without Can Edit permission on the workbook; see Hidden pages and controls in workbooks.
Controls in the Dashboard URL
When you create a public or private embed, you may choose to include control values in the embed URL yourself. These can be added into the embed URL like any other workbook URL; see Workbook control values in the URL.
The creation process for User-Backed embeds is more complex. In these cases, initial control values should be injected into the URL when the adding embedding to your application.
Types of Embedding
User-Backed Embeds
Sigma provides secure embedding capabilities that enable users to seamlessly integrate Sigma's analytics and business intelligence platform into their own applications or workflows.
User-Backed Embeds provide the capacity to securely manage your users in Sigma. By treating all users as unique, embeds enable custom permissions, row-level security, and access to specific (or generic) dashboards. You can configure an embed to allow users to save and edit their own versions of embedded workbooks. Users can also create and save their explorations, create schedules, and manage their folders.
Sigma provides secure user sessions by leveraging unmodifiable URLs that can't be shared or reused. User permissions and row-level security ensure that users can only view data they're authorized to access; see User-backed embedding.
Public
Public embeds are available to anyone with the embed URL. This is a good option if you want to display your embed on a public facing website. Please be sure you only show the data you want others to see.
Access to a public embed will not allow someone to access your data deeper in Sigma without a Sigma account for your organization; see Public embedding.
Private
Private embeds are only visible to your Sigma organization’s members with access granted on the workbook. An organization member must be logged into their Sigma account to view the embed. If they are not logged into Sigma, the embed will prompt them to sign in to their account.
Private embeds are only supported for full workbooks; you cannot use a private embed for a single workbook page or element.
This type of embedding may be useful for displaying your analytics in internal tools, like a company only portal a television in your workspace; see Private embedding.
Application (Legacy)
Application Embedding isn't supported for new customer configurations. New customers should use User-backed embedding.
Application embedding is a way to securely embed your data without requiring users to authenticate through Sigma. This type of embedding is useful when you are embedding Sigma into your applications for your customers.
To create an application embed, you will use a Sigma embed secret, custom session times, and a server side generated embed URL; see Application embedding.