> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Enabling iframe-restricted functionality for embedded instances

> Enable functionality for embedded content that iframes restrict by default.

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:

| Parameter                             | Description                                                                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| [`clipboard-write`](#allow-clipboard) | Enables clipboard access, allowing users to copy data values from embedded Omni                                    |
| [`microphone`](#allow-microphone)     | Enables microphone access, allowing users to use the Omni Agent's voice mode feature                               |
| [`fullscreen`](#allow-fullscreen)     | Enables fullscreen viewing for dashboards and workbooks through the user's native browser fullscreen functionality |

<h2 id="allow-clipboard">
  Allow copying in embed iframes
</h2>

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:

```html wrap theme={null}
<iframe src={omni-embed-url} allow="clipboard-write" />
```

<h3 id="restrict-clipboard">
  Restrict copying by domain
</h3>

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

```html wrap theme={null}
<iframe src={omni-embed-url} allow="clipboard-write self https://acme.embed-omniapp.co/" />
```

<h2 id="allow-microphone">
  Allow Omni Agent voice mode in embed iframes
</h2>

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:

```html wrap theme={null}
<iframe src={omni-embed-url} allow="microphone" />
```

<h2 id="allow-fullscreen">
  Allow full screen mode in embed iframes
</h2>

<Note>
  `allowfullscreen` currently only applies to dashboards and workbooks. Apps are not yet embeddable, but will be in the near future.
</Note>

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:

```html wrap theme={null}
<iframe src={omni-embed-url} 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.

## Combining embed iframe permissions

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

```html wrap theme={null}
<iframe src={omni-embed-url} allow="clipboard-write microphone" />
```