Skip to main content
By default, iframes restrict access to certain functionality that could pose a security risk, such as copying or using the microphone. However, you can allow your users to use these features by including them in your iframe declarations.

​
Supported features

The following Omni features can currently be enabled through the allow parameter in iframe declarations:

​
Allow copying in embed iframes

Access to the viewing device’s clipboard is restricted by default. This means that when you click on a data value within Omni and select Copy value, the value will not be copied to your clipboard. To allow clipboard access, add allow="clipboard-write" to your iframe declaration:

​
Restrict copying by domain

To only allow copying from a specific domain, modify the allow clause to include the specific domain:

​
Allow Omni Agent voice mode in embed iframes

When using the Omni Agent’s voice mode feature, microphone access will be blocked unless explicitly allowed. Adding allow="microphone" to your iframe declaration will enable voice mode:

​
Allow full screen mode in embed iframes

Embedded dashboards, workbooks, and apps can request native browser fullscreen when a viewer uses the full screen toggle, hiding browser and OS chrome for a distraction-free presentation. To enable this functionality for embedded content, add allow="fullscreen":
Without this attribute (or on iOS Safari, which does not support fullscreen viewing for embedded content), Omni falls back to a CSS-only overlay presentation. The overlay still provides a focused view within the available viewport, but browser and OS chrome remain visible.
To build a custom fullscreen control in your parent application or stay in sync with fullscreen state changes, use the fullscreen:changed event to listen for fullscreen transitions and the fullscreen:set event to programmatically control fullscreen mode. See the fullscreen:set example for a complete parent-controlled fullscreen implementation.

​
Combining embed iframe permissions

A single allow attribute can include multiple permissions. For example, to enable both voice mode and value copying: