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:

Generate the secure embed path

Before you can embed Sigma content into a host application, you must generate a secure embed path within Sigma.

  1. Open the workbook containing the content you want to embed.

  2. 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.

  3. In the workbook header, click the caret () associated with the workbook's name.

  4. In the workbook menu, select Embedding.

    Image of the document menu open, with the mouse selector hovering over Share and export > Embedding.
  5. In the Embed workbook modal, select the Secure tab.

  6. 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.

    Image of the "Generate secure embed path for" menu open, with the mouse hovering over one of the options.

    📘

    If you want to embed a workbook page that opens a modal, you must embed the entire workbook.

  7. 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.

    Image of the mouse hovering over the copy button for the secure embed path.
  8. To test the embed in Sigma's embed sandbox, click Test and see Test embeds in sandbox environment.