# Embedded External Content (iFrame)

<figure><img src="https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-ac39db096de477320a5fb28d669e0e1b793f8df4%2Fembedded-external-content-container-v184-0.png?alt=media" alt="" width="300"><figcaption></figcaption></figure>

The Embedded External Content Web Control allows an app builder to embed external websites within their applications. It should be noted that in many cases, external websites will not display correctly within the application in a user's browser due to [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) or other security mechanisms employed by sites to prevent content being embedded externally.

> 📘 This feature is intended for App Builders to embed sites which they have control over so that the necessary security mechanisms can be set to allow Airkit to embed the desired content.
>
> It should be noted that the embedded content is set within a Sandbox iFrame. This means that the embedded content cannot communicate to the web page or the rest of the Airkit application.

## Properties

### General

#### Source URL

Expects type `text`.

The URL of the desired webpage to display.

#### Title

Expects type `text`.

Sets the title property of the iFrame.

### Accessibility

#### Aria Label

Expects type `text`.

Defines a value to the aria-label of the control for accessibility. For more information see [here](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html).

### State

#### Is Visible

If `TRUE` the control will be visible. If `FALSE` the control will not be displayed. If the field is empty, the control will be visible.

#### Is Disabled

Expects type `boolean`.

If `TRUE` the control will be disabled and the user will not be able to interact with it. If `FALSE` the control will be enabled. If the field is empty, the control will be enabled.

## Style

Check [Common style properties of web controls](../styling/styling-overview/web-control-styling-properties) for details on how to style this Web Control.

## Embedded Iframe Outgoing Event

![](https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-0758c40fdc6215076c6e0bbd6dc9728b08da6281%2Fembedded-external-content-container-v184-1.png?alt=media)

Provides the ability to run an event (action chain) from inside the embedded External Content control to the App and also the ability to send data to the iFrame control.

### Outgoing event on the embedded iFrame

To create an outgoing event on the embedded iFrame, click on the '+' icon next to the Embedded External Content container. This creates an outgoing event that will send a payload to the iFrame. The process is similar to [Passing Data](https://github.com/airkit/airkit-docs/blob/master/docs/passing-data/README.md#outgoing-events) with the only difference is creating the Outgoing Event on the Embedded External Content control.

### Incoming event from the embedded iFrame

To receive the event from the iFrame to the Airkit App, create the incoming event in the Connections Builder and use the Web SDK to trigger the event from the iFrame. For more information, see [Passing Data](../../embeds/sdks/passing-data#incoming-events).

## Example

Use this control to prompt users to visit your website:

![](https://2599974655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIRF6etABDVMr59RdpyGw%2Fuploads%2Fgit-blob-ac39db096de477320a5fb28d669e0e1b793f8df4%2Fembedded-external-content-container-v184-2.png?alt=media)
