Generate a secure embed path
To create a secure embed within a host application, you must first generate a secure embed path (URL) that points to the specific Sigma content you want to embed (an entire workbook, a specific page, or an individual chart or table element.)
This step is only necessary if you are creating secure embed URLs without JSON Web Tokens (JWTs). If you are signing your embed URLs with JWTs, see What URL to use to construct your secure URL.
This document provides an overview of the requirements and explains how to generate a secure embed path.
System and user requirements
The ability to create and manage embeds requires the following:
- Secure embedding must be enabled for your organization.
- You must be assigned the Admin account type or have been granted embedding credentials by an admin. See Generate embed client credentials for more information.
- You must have created at least one embed user team and shared the content you want to embed with that team. See Create a team for embed users.
Generate the secure embed path
Before you can embed Sigma content into a host application, you must generate a secure embed path within Sigma.
-
Open the workbook containing the content you want to embed.
-
Ensure that the version of the content you want to embed is published. If it isn't, open the workbook in Edit mode and click Publish.
Embeds only display published content. If a workbook, page, or element is updated in the draft version and not published, the embed displays the published version.
-
In the workbook header, click the caret (
) associated with the workbook's name.
-
In the workbook menu, select Embedding.
-
In the Embed workbook modal, select the Secure tab.
-
In the Generate secure embed path for dropdown, select the content you want to embed. This can be the entire workbook, a specific page, or an individual chart or table element.
If you want to embed a workbook page that opens a modal, you must embed the entire workbook.
-
Sigma immediately generates a secure embed path. Click Copy to use the URL in the host application's API.
You can securely store the embed path for future reference, or you can return to this modal to retrieve the embed path at any time.
-
To test the embed in Sigma's embed sandbox, click Test and see Test embeds in sandbox environment.
Updated 5 days ago