> 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 %}