> For the complete documentation index, see [llms.txt](https://mpithemes.gitbook.io/triumph/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mpithemes.gitbook.io/triumph/popups-queue/popup.md).

# Popup

Displays a popup window for promotions, announcements, newsletter signup, or other important content.

**Test mode in editor**\
Disables automatic opening and closing actions while editing, making it easier to preview and customize the pop-up in the editor.

**Popup type**\
Choose how the pop-up appears:

* **Standard modal** – Displays the pop-up with a blurred page overlay.
* **Floating (no overlay)** – Shows a floating pop-up without blocking the page.\
  *Note: Floating pop-up allows customers to continue scrolling the page.*

**Show only on home page**\
Displays the pop-up only on the homepage.

**Show on mobile**\
Allows the pop-up to appear on mobile devices.

**Auto-open delay**\
Sets the wait time before the pop-up opens automatically (0-60 sec).

**Auto-close**\
Automatically closes the pop-up after a set time period.\
*Note: Works only on desktop devices.*

**Auto close after**\
Specify the time after the pop-up closes automatically (5-60 sec).

**Don't show again**\
Controls how long the pop-up stays hidden after a customer closes it: None, 1 hour, 1 day, 1 week, 1 month.\
*Note: This works only on the live store (not in the editor).*\
*If the pop-up contains a subscription form, it will automatically stay hidden permanently after a successful sign-up.*

#### Image

**Show image**\
Displays an image inside the pop-up.

**Image**\
Upload or select an image for the pop-up.

**Image position**\
Controls where the image appears to the left, top, or right.

**Image fit**\
Choose how images fit inside the container:

* **Full background** – Fills the space (may crop the image).
* **Contain** – Shows the full image (may leave empty space).

**Image width on desktop**\
Adjusts how much space the image takes on desktop screens (30–50%).

**Desktop layout**\
Controls where the pop-up appears on desktop screens: Left, Center, or Right.

**Width**\
Sets the pop-up width on desktop screens (400–1000 px).

#### Colors

**Background**\
Sets the pop-up background color.

**Text**\
Controls the text color.

**Accent**\
Sets the accent color used for highlights and interactive elements.

**Auto close timer**\
Changes the progress line color.

{% tabs %}
{% tab title="Desktop" %}

<figure><img src="https://4126621502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpREZeVZogNLjx09og4O%2Fuploads%2F3lZm2lzb0AoyVgwPlzW0%2Fpopup_desktop.png?alt=media&amp;token=e1e2d5e5-3f49-4768-b20a-67bd6b5c0f08" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Mobile" %}

<figure><img src="https://4126621502-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkpREZeVZogNLjx09og4O%2Fuploads%2FEkVgzq80w5zd7gaZR6k5%2Fpopup_mobile.png?alt=media&amp;token=2580db63-57ef-44f2-8589-1fa7cb86aaaa" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://mpithemes.gitbook.io/triumph/popups-queue/popup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.