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
allowfullscreen currently only applies to dashboards and workbooks. Apps are not yet embeddable, but will be in the near future.
Dashboards and workbooks 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" to your <iframe> declaration:
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.
Combining embed iframe permissions
A single allow attribute can include multiple permissions. For example, to enable both voice mode and value copying: