# 2. Configure Embed

## Create Embed Configuration

On the page with Embed Configurations you can create a new Configuration and manage the existing ones:

<figure><img src="/files/TaPnKIbGyYdY2uYlOn7I" alt=""><figcaption><p>Configurations page</p></figcaption></figure>

To create a new Embed:

1. Click the **Add** button in the top left corner. The Embed creation dialog will then appear:<br>

   <figure><img src="/files/MB9lcVIAi6IKn2C3W649" alt=""><figcaption><p>Create Embed dialog</p></figcaption></figure>
2. Specify the following fields:
   * **Name** - This is an internal name used only for your reference.
   * **Allowed domains** - You can enter one or more domains where the iframe will be allowed to be displayed. If you enter multiple domains, separate them by commas. Wildcard with `*` are also allowed (e.g. `*.example.com`).
   * **Custom CSS** - CSS rules used to customize the iframe for an End User&#x20;
   * **Proprietary connector** - Your own connector or another connector of which you already have the credentials for all your end users, so that your users don't have to fill it in ([more details](/embed-white-label-portal/embed-admin-setup/2.-configure-embed/proprietary-connector-setup.md)) *- Optional*
   * **Sharing level** - Whether flows and connector auth are shared on a per-user or a per-account basis ([more details](/embed-white-label-portal/embed-admin-setup/2.-configure-embed/sharing-level.md))
   * **Ask for consent** - Whether your end users should be asked for consent (for GDPR compliance) when they open the iframe for the first time ([more details](/embed-white-label-portal/embed-admin-setup/2.-configure-embed/consent-screen.md))  *- Optional*
3. Сlicking **Submit** to save Embed Configuration. Its secret token and iframe code will be generated. You can see both by clicking on the **edit** button of the new Embed in the list of Embed Configurations:<br>

   <figure><img src="/files/OxIzSpyY0IRIMkY9Fc27" alt="" width="563"><figcaption><p>The secret token (needed for JWT) and the iframe code - ready to be copy and pasted to your app</p></figcaption></figure>
4. Finish setup. Depending on the Embed version, the process is slightly different

{% tabs %}
{% tab title="Embed V1" %}
Steps to Configure Embed V1

* **Access the Groups Section**:
  * In the Embed Configuration, select **Groups**.
  * **Groups** allow you to organize integrations (Flows) into groups for end users in the iframe

<figure><img src="/files/eIAq43c5cytd5lGwT04Z" alt=""><figcaption><p>Embed V1</p></figcaption></figure>

* **Add a Group**:
  * On the **Groups** page, click **Add**
  * In the dialog box, specify
    * **Name**: This is the name of the group displayed in the iframe.
    * **Highlighted Connectors (Optional)**: Select Connectors to display their logos on the group in the iframe
    * **Sharing settings (Optional):** Assign specific users or teams the ability to view or run the integrations.

<figure><img src="/files/f4B6jI4FivCdXHdALZVV" alt="" width="563"><figcaption><p>Create / Edit Group dialog</p></figcaption></figure>

* **Add Flows to the Group**:
  * Open the newly created **Group**
  * Click **Flows**
  * Add the desired Flow that will be available for the end user
    {% endtab %}

{% tab title="Embed V2" %}
Steps to Configure Embed V2

* **Access the Partners Section**:
  * In the Embed Configuration, select **Partners**<br>

    <div align="center"><figure><img src="/files/4BrOX4HJlZX4AieFjedM" alt=""><figcaption><p>Embed V2</p></figcaption></figure></div>
* **Add a Partner**:

  * On the **Partners** page, click **Add**
  * In the dialog box, specify
    * **Partner:** The partner's logo visible in the iframe
    * **Category:** Category name visible  in the iframe
    * **Sharing settings (Optional):** Assign specific users or teams the ability to view or run the integrations.

  <figure><img src="/files/di1oet4BjyOKfmDicA6E" alt="" width="563"><figcaption><p>Create / Edit Partner modal</p></figcaption></figure>
* **Navigate to Use Cases**:
  * Press **Use Cases**
  * On the **Use Cases** page, click **Add**
  * A dialog box will appear<br>

    <figure><img src="/files/9lCGoolTFmNpyUh8NYLB" alt="" width="563"><figcaption><p>Create / Edit Use Case modal</p></figcaption></figure>
* **Add Flows to the Use Case**:
  * Open the newly created **Use Case**
  * Click **Flows**
  * Add the desired Flow that will be available for the end user
    {% endtab %}
    {% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.locoia.com/embed-white-label-portal/embed-admin-setup/2.-configure-embed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.