> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Embed URL parameters

> Customize Sigma secure embeds with URL query string parameters to control menus, controls, and embed behavior.

When you create a secure embed, you can use URL query string parameters to customize additional functionality, in addition to what is provided by [JWT claims](/docs/json-web-token-claims-reference) for your secure embed.

The query string parameters listed in the [available interface parameters](#available-interface-parameters) table are supported for a JWT-signed URL.

For details about URL parameters available for secure embed URLs secured with client credentials, see [Add URL parameters to a secure embed](/docs/embed-url-parameters).

You can also set control values using query string parameters, making sure that your secure embed loads with specific control values specified. See [Set control values in a URL using query string parameters](/docs/workbook-control-values-in-the-url).

## Usage notes

* Query string parameters are applied at the end of a URL path. The first parameter follows a question mark (`?`) and additional parameters are added after an ampersand (`&`).

* Values that you provide in the embed URL must be URL-encoded. For details, see [URL encoding reference for parameters](/docs/special-characters-for-url-parameters).

  If a parameter contains multiple values, do not encode the commas separating the values. The value of the parameter must be passed to Sigma in the URL as `value1,value2` rather than `value1%2Cvalue2`.

* Parameter values are case sensitive. For example, you must specify `true` instead of `True`.

## Available interface parameters

The following query string parameters are available to manage the display and functionality of the embedded Sigma user interface. Parameters not listed in this table are available as [JWT claims](/docs/json-web-token-claims-reference), account type permissions, or are not supported.

| Parameter                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `:coep`                      | When set to `require-corp`, includes the <a href="https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cross-Origin-Embedder-Policy" target="_blank">Cross-Origin-Embedder-Policy</a> header with the `require-corp` token in responses, allowing the embed to load in a <a href="https://developer.mozilla.org/en-US/docs/Web/API/Window/crossOriginIsolated" target="_blank">cross-origin isolated</a> page. This parameter blocks externally hosted resources, such as plugins, maps, and image uploads, from loading. |
| `:hide_bookmarks`            | When set to `true`, hides saved views from the embed menu.                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `:hide_element_interactions` | When set to `true`, hides the element toolbar. The filter menu, <img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/more.svg" alt="" /> **More** menu, and other options in the element toolbar are hidden.                                                                                                                                                                                                                                                                                                        |
| `:hide_explore_toggle`       | When set to `true`, hides explore toggle from the embed menu.                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `:hide_folder_navigation`    | When set to `true`, hides the folder navigation.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `:hide_menu`                 | When set to `true`, hides the embed menu in saved workbooks. Must be used with `menu_position` and only applies when `menu_position` is set to `top` or `bottom`.                                                                                                                                                                                                                                                                                                                                                                        |
| `:hide_save_as`              | When set to `true`, hides the **Save As** button in the embed menu without hiding page navigation or the rest of the menu bar.                                                                                                                                                                                                                                                                                                                                                                                                           |
| `:hide_schedule`             | When set to `true`, hides the menu option to schedule an export. This parameter does not prevent users from scheduling exports. Use the [**Schedule export**](/docs/account-type-and-license-overview) feature permission to manage access. See [Manage access to a secure embed](/docs/manage-access-to-a-secure-embed).                                                                                                                                                                                                                |
| `:hide_send`                 | When set to `true`, hides the menu option to download files for an element, page, or workbook. This parameter does not prevent users from downloading data. Use the [**Download**](/docs/account-type-and-license-overview) feature permission to manage access. See [Manage access to a secure embed](/docs/manage-access-to-a-secure-embed).[^1]                                                                                                                                                                                       |
| `:hide_tooltip`              | When set to `true`, hides chart mark tooltips.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `:lng`                       | Sets the language to use for Sigma text to the embed. If a [translation file is defined](/docs/manage-workbook-localization) for that language, applies any defined translations to custom text in the workbook.                                                                                                                                                                                                                                                                                                                         |
| `:lng_variant`               | Applies any defined translations from a [custom translation file](/docs/manage-workbook-localization) to the embed. Must be used with `lng`.                                                                                                                                                                                                                                                                                                                                                                                             |
| `:menu_position`             | Changes the toolbar position (`top`, `bottom`) or removes it (`none`). When no value is specified, defaults to `none`.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `:responsive_height`         | When set to `true`, enables developer access to the JavaScript event called [`workbook:pageheight:onchange`](/docs/outbound-event-reference#workbookpageheightonchange). If adding this parameter to workbook edit URLs (which include `/edit`), set to `false`.                                                                                                                                                                                                                                                                         |
| `:show_assistant`            | When set to `true`, show the Assistant in a workbook, whether viewing the published or tagged version, or editing a draft of the workbook. Only applies when a full workbook is embedded.                                                                                                                                                                                                                                                                                                                                                |
| `:theme`                     | Apply a [workbook theme](/docs/create-and-manage-workbook-themes) by name, case sensitive. Specify one of the default workbook themes (`Light`, `Dark`, or `Surface`) or any custom theme defined for your organization.                                                                                                                                                                                                                                                                                                                 |

For more information about the `:responsive_height` parameter and implementing responsive embeds, see the section about responsive iframes in the <a href="https://quickstarts.sigmacomputing.com/guide/embedding_11_responsive_embeds_v3/index.html" target="_blank">Embedding 11: Responsive Embeds</a> Sigma QuickStart.

[^1]: Options to download a PDF of a workbook page and PNG of an element are not hidden by the `:hide_send` parameter and are not restricted by the **Download** feature permission because a user can always take a screenshot of the embedded content.