RingCX agent scripting elements: iFrame
=======================================

The iFrame element allows you to insert an entire, fully functional live website into a script so agents can remain in the app (and on the same page of the script) even if they need to access another site.

First, you need to add the iframe to the page element in the script, then you can manage the settings for the iframe.

For more information on basic element settings and agent scripting, see:

* [Editing Page elements: the basics](https://support.ringcentral.com/article-v2/RingCX-Editing-Page-elements-the-basics.html?brand=RingCentral&product=RingCX&language=en_US "")
* [Adjusting elements on a script page](https://support.ringcentral.com/article-v2/Adjusting-elements-on-a-script-page-in-RingCX.html?brand=RingCentral&product=RingCX&language=en_US "")
* [Intro to agent scripting in RingCX](https://support.ringcentral.com/article-v2/Intro-to-agent-scripting.html?brand=RingCentral&product=RingCX&language=en_US "")

Adding an iframe element to an agent script
-------------------------------------------

To open a script and add an iframe:

* In the [<var class="keyword">
  <div style="display: inline;">
  Admin Portal
  </div></var>](https://service.ringcentral.com ""), click **Contact Center** , then select *Admin*. Sign in to [<var class="keyword">
  <div style="display: inline;">
  RingCX
  </div></var>](https://ringcx.ringcentral.com/ "") and click the **Admin** tile.
* In the left navigation, click the **Agent tools** icon (A), then click **Script designer** (B).

  ![Click Agent tools icon then click Script designer](https://assets.ringcentral.com/content/dam/xml-assets/doc_team/en_us/ringcentral/RingCX/RingCX-agent-scripting-elements-iFrame/images/1-agent-tools-script-designer.png)

* Click the script you want to add an iframe to.
* In the left navigation, click **Script Studio**.
* Hover over the page element you want to add the iframe to, then click **Edit** .

  ![Click Edit](https://assets.ringcentral.com/content/dam/xml-assets/doc_team/en_us/ringcentral/RingCX/RingCX-agent-scripting-elements-iFrame/images/2-edit-page-element.png)

* Click the **Add Element** dropdown, then select *iFrame*.

Once you've added the iframe to the page element, you can manage the settings for that element.

Managing iframe settings
------------------------

To edit the iframe:

* Click the **gear** icon on the iframe field, then click **Edit** .

  ![Click the gear icon then click Edit](https://assets.ringcentral.com/content/dam/xml-assets/doc_team/en_us/ringcentral/RingCX/RingCX-agent-scripting-elements-iFrame/images/3-edit-element.png)

* Edit the settings on the [Configuration](#configuration ""), [Styles](#styles ""), and [Actions](#actions "") tabs.
* Click **Done**.

### Configuration

On the **Configuration** tab, you have the following option:

* **Input Label**: Type an input label for the iframe.
* **Resource URL**: Enter the website URL you want to include on the page. Any site that you add as an iframe must be secure (https://), and have its iframe permissions enabled in order for you to insert it into your script. Note that some websites do not allow their content to be displayed in an iframe

### Styles

On the **Styles** tab, you have the following options:

* **Color**
* **Element CSS**: Enter any custom CSS for the iframe.

### Actions

On the **Actions** tab, you have the following options:

* **Disabled Condition** : Enter the condition for which to disable the element. Click **{{add tag}}** to select a [data model](https://support.ringcentral.com/article-v2/Using-the-RingCX-Data-Builder-tool.html?brand=RingCentral&product=RingCX&language=en_US "") to bind.
* **Hidden Condition** : Enter the condition for which to hide the element. Click **{{add tag}}** to select a [data model](https://support.ringcentral.com/article-v2/Using-the-RingCX-Data-Builder-tool.html?brand=RingCentral&product=RingCX&language=en_US "") to bind.

**Additional resources**

[Editing Page elements: the basics](https://support.ringcentral.com/article-v2/RingCX-Editing-Page-elements-the-basics.html?brand=RingCentral&product=RingCX&language=en_US "")  
[Adjusting elements on a script page](https://support.ringcentral.com/article-v2/Adjusting-elements-on-a-script-page-in-RingCX.html?brand=RingCentral&product=RingCX&language=en_US "")  
[Intro to agent scripting in RingCX](https://support.ringcentral.com/article-v2/Intro-to-agent-scripting.html?brand=RingCentral&product=RingCX&language=en_US "")

