# Add/Edit Popups

## Before You Start

Please review the popup editor fields found below before adding/editing any popups!

{% content-ref url="editor-field-definitions" %}
[editor-field-definitions](https://docs.satisfilabs.com/resource-center/ai-agent-engine/enhance-the-chat-experience/popups/editor-field-definitions)
{% endcontent-ref %}

## Add/Edit Your Popups

{% tabs %}
{% tab title="Add a New Popup" %}
While in the popup window:

1. In your admin dashboard, go to **Studio -> Popups**
2. Click the "+" icon in the top right-hand corner of the screen. 
3. Name the popup and make any adjustments to the prompts, labels, theme, etc. before hitting "Save New". For more information on the available fields, review the article here: [editor-field-definitions](https://docs.satisfilabs.com/resource-center/ai-agent-engine/enhance-the-chat-experience/popups/editor-field-definitions "mention")
4. Add the new Popup Rule by clicking the "+" in the bottom right-hand corner of the Popup Editor window. If you do not assign a page within this rule section, no chat will appear! Learn more about Popup Rules below. 
5. Hit **Save New**
6. To install the new popup on your website, follow the instructions found here:

{% content-ref url="../../install-your-chat" %}
[install-your-chat](https://docs.satisfilabs.com/resource-center/ai-agent-engine/install-your-chat)
{% endcontent-ref %}

{% hint style="warning" %}
If you prefer to utilize your own webpage elements for user actions such as: 

* Surfacing/Opening the Popup
* Close/Hide the Popup

Please use the advanced popup installation instructions here: [advanced-pop-up-options](https://docs.satisfilabs.com/resource-center/ai-agent-engine/install-your-chat/web-installation/advanced-pop-up-options "mention")
{% endhint %}
{% endtab %}

{% tab title="Edit An Existing Popup" %}
While in the popup window:

1. In your admin dashboard, go to **Studio -> Popups**
2. Click the pencil icon next to the popup you'd like to make adjustments for. 
3. Make any adjustments to the prompts, labels, theme, etc. before hitting "Save". For more information on the available fields, review the article here: [editor-field-definitions](https://docs.satisfilabs.com/resource-center/ai-agent-engine/enhance-the-chat-experience/popups/editor-field-definitions "mention")
4. Adjust the Popup Rules if needed by clicking the pencil icon or by adding a new rule.
5. Hit **Save**
   {% endtab %}
   {% endtabs %}

### Add/Adjust Popup Rules

Each popup needs to have a rule tying it to a specific chat page. If you do not create a rule assigning a chat page to your popup, no chat will appear within the popup container. 

<figure><img src="https://167344003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsxN9AGLZMIc5C8dx3zU7%2Fuploads%2FyapT6KVIdoMUOZDaAtps%2Fimage.png?alt=media&#x26;token=9a8674e8-d2fb-4440-9be5-daf5f8614347" alt=""><figcaption><p>Example of a Popup Rule</p></figcaption></figure>

1. Navigate to your popup's editor window
2. Add the new Popup Rule by clicking the "+" in the bottom right-hand corner or selecting the pencil icon to edit an existing rule.&#x20;
3. Update the following rule fields:

| Field      | Description                                                                                                                                                                                                                                                     |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Priority   | Set the priority of a rule over other existing rules.                                                                                                                                                                                                           |
| Match Type | <p><strong>Default:</strong> Your new popup always defaults to use a particular chat page.</p><p></p><p><strong>Contains:</strong> If this popup's code snippet is placed on a webpage that contains certain text in the URL, it will override the default.</p> |
| Match Text | Not needed if using "Default" as match type. If using "Contains", "Starts/Ends With", or "Equals", add text to match up with this popup.                                                                                                                        |
| Page       | Apply the page you'd like to link to this popup.                                                                                                                                                                                                                |

4. Hit **Save**


---

# 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.satisfilabs.com/resource-center/ai-agent-engine/enhance-the-chat-experience/popups/add-edit-popups.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.