Source: https://nishanth-fern-test.docs-staging.pageloop.ai/mirror/create-a-pop-up-on-mirror

# Create a Pop-up on Mirror

## Overview

Whatfix enables you to create a Pop-up on a Mirror simulation to display a focused, overlay message that introduces a workflow, communicates key information, or prompts learners to take an action. The Pop-up appears as a layer over the Mirror Screen and does not anchor to a specific element, so you can use it to set context for the entire screen.

For example, you can create a Pop-up on a Mirror simulation to welcome learners at the start of a new hire onboarding module, summarize what the simulation will cover, and launch a Flow that walks them through the workflow.

## Use Cases

- Introduce a simulation or workflow on the first Mirror Screen so learners know what they are about to practice.
- Announce a new feature or process change inside a training module before learners interact with it.
- Prompt learners to begin a Flow, watch a video, or acknowledge instructions before proceeding through the simulation.

## Create a Pop-up

Expand the following accordions for more details:

****Step-1: Create a Pop-up****

Use the following steps to create a Pop-up:

1. Log in to the application where you want to create content, and then launch Whatfix Studio.

![](/images/39/CLM_editor-plug-in-396ca7a7.png)
2\. Under **WIDGETS**, click **Pop-up**.

![](/images/93/Whatfix_Studio_Click_Pop-up-931641af.png)
3\. Select the required Pop-up template. For more information, see [Select a Template](/web/create-pop-up-with-templates#step-1-select-a-template).

![](/images/bd/Whatfix_Studio_Select_Pop-up_Template-bd4a83c1.png)

> [!INFO]
>
> Use the **Filter** option to filter the templates by Use Case, Type, or Component.
>
> ![](/images/09/image-GSK9FAQK-098bf498.png)
>
> The following table lists all the available filters:
>
> | Filter    | Values                                                                                   |
> | --------- | ---------------------------------------------------------------------------------------- |
> | Use Case  | Outage Alerts, Maintenance, Training, Feature Updates, Policy Updates, and Announcements |
> | Type      | Modal, Snackbar, and Carousel                                                            |
> | Component | Media and Text and Only Text                                                             |

4. In the **Appearance** section, you can configure the **Background**, **Padding**, and **Border Radius** of the Popup. ![](/images/a6/image-7921ZFDA-a6dab958.png)

Expand the following accordion for more details:

****Configure Background, Padding, and Border Radius****

**Background** Choose between **Color** or **Image**:

- For **Color**:
  - You can select **Solid** or **Gradient** option ![](/images/f0/image-V8145OQP-f02b5bde.png)
  - You can also set the background color to transparent if required.
  - Or use color picker and specify HEX, or RGBA values
- For **Image**:
  - You can choose to **Replace** or **Delete** the default image or GIF ![](/images/4d/image-FZ43DDJZ-4dfde503.png)
  - Upload supported formats (such as, PNG, JPG, GIF, or SVG)

Here’s how you can choose the background color for your Popup:

![](/images/24/Appearance-Color-24fe1261.png)

**Padding** Padding defines the inner spacing between the popup edges and its content.

- Enable **Uniform padding** to apply the same spacing on all sides ![](/images/18/image-BY53TLCM-183874c4.png)
- Disable to configure **Top, Right, Bottom, and Left** individually
- Range: **0px to 64px**
- Default: **20px**

**Border Radius** Border radius controls how rounded the corners of the popup appear.

- Enable **Uniform radius** to apply the same value to all corners
- Disable to configure each corner individually
- Range: **0px** (sharp corners) **to 64px** (fully rounded)
- Default: **20px**

1. In the **Position** section, configure the **Overlay** and position of the Popup.

> [!INFO]
>
> **Overlay**
>
> When you enable or disable the **Overlay** toggle, it controls how the background behind the popup appears. Position cannot be configured when Overlay is enabled.
>
> ![](/images/08/image-0Z9XUCQZ-0845b402.png)
>
> - **Dim**: When Overlay is enabled, adds a darkened overlay behind the popup.
> - **Blur**: When Overlay is disabled, applies a blur effect to the background content.
>
> **Position**
>
> Configure where the Popup appears on the screen. To change the position, disable the **Overlay** toggle, and then:
>
> - Select a position from the **3×3 grid**:
>   - Top-Left, Top-Center, Top-Right
>   - Middle-Left, Middle-Center, Middle-Right
>   - Bottom-Left, Bottom-Center, Bottom-Right
> - Default position: **Middle-Center**

2. In the **Control** section, you can configure the behavior of the Popup. ![](/images/28/image-4QBYLQ14-283d2cb8.png)

Expand the following accordion for more details:

****Configure theme, behavior, and interactions****

**Control theme** (applicable to **Close (X)** and **Don’t show me again** buttons)

- Choose theme: **Light** or **Dark**

---

**Show close (X) button**

- Toggle to show or hide the close button
- When enabled, appears at the top-right corner of the Popup

---

**Don’t show me again**

- Enable to allow users to opt out of seeing the Popup again.

---

**Title for screen reader**

- Add a descriptive title for accessibility
- The specified text is read by screen readers

> [!WARNING]
>
> The accessibility feature is not available by default. To enable, contact [support@whatfix.com](mailto:support@whatfix.com?subject=Enable%20WCAG%20for%20Popups\&body=Hi%2C%0A%0APlease%20enable%20accessibility%20for%20Popups.).

---

**Carousel** (applicable only for carousel templates)

> [!WARNING]
>
> This section appears in the Controls accordion **only when a carousel template is selected**. For more information, see [Create a Carousel Pop-up](/web/creating-a-carousel-pop-up).

- Enable or disable the **Move slides automatically** toggle.
  - **Toggle ON (default):** Slides transition automatically at the configured interval.
  - **Toggle OFF:** Slides advance only when the end user manually clicks an arrow or a marker.
- Set delay: In the **Delay by** field, specify by how many seconds the next slide should appear (the default is four seconds). ![](/images/61/image-OLUNLH03-61e35156.png)

> [!WARNING]
>
> When **Move slides automatically** is enabled:
>
> - When end-users hover over the Popup, it pauses the slide transition.
> - When users move the cursor away, the timer resumes from where it paused and the next slide appears based on the remaining time.

- Configure navigation for the Popup. In the **Show** dropdown, select from three options: ![](/images/43/image-YR6PLYBV-43d6c1f6.png)
  - **Both arrows and markers** (displays both left and right arrow marks, and dot indicators) ![](/images/c0/image-48OVG94V-c0b5f767.png)
  - **Only Arrows** (displays left and right arrow marks only)
  - **Only Markers** (displays dot indicators only)

---

**Add Carousel slides**

- Use the **+ Add** button to add new slides to the carousel. The active slide being edited is visually highlighted. ![](/images/f6/image-58NABU3N-f6bdd3b1.png)

1. Click Save **Popup**.

![](/images/3c/image-3MC1AU49-3cb7d2e5.png)

> [!WARNING]
>
> Once you have created the Pop-up, it is automatically created on your Whatfix Guidance Dashboard. For more information, see [Overview of the Whatfix Guidance Dashboard](/web/overview-of-the-whatfix-dashboard).

****Step-2: Configure the Visibility Rules for the Pop-up****

Use the following steps to configure visibility rules for a Pop-up:

1. On the [Whatfix Guidance Dashboard](/web/overview-of-the-whatfix-dashboard), click **Widgets**.

![](/images/ee/ia_left_nav_content-ee088564.png)
2\. Click **Pop-ups**.

![](/images/15/Whatffix_Guidance_Dashboard_Click_Pop-ups-158b8e41.png)
3\. Hover your cursor over the Pop-up you want to configure, and then click the **Edit** icon.

![](/images/7f/CLM_DB_Click_edit_icon-7f5dddac.png)
4\. Click **Set Visibility Rules**.

![](/images/24/DB_Survey_set-VR-241f7146.png)
5\. Expand the **Where does the self help appear?** section, and configure URL and Page tags. For more information, see [Set Where your Content or Widget appears with the New Visibility Rules](/web/set-where-your-widget-appears).

![](/images/b3/Whatfix_Guidance_Db_SH_Where_Rules-1-b3a99cc7.png)
6\. Expand the **When does the self help start and stop appearing?** section, and configure when you want to start showing your widget. For more information, see [Set When your Content or Widget Appears with the new Visibility Rules](/web/set-when-your-widget-appears-using-visiblity-rules-20).

![](/images/20/Whatfix_Guidance_Db_When_Rules-20554f1f.png)
7\. Expand **Who does the Pop-up appear to?** section, and configure who you want to show your content to. For more information, see [Set Who can see your Content or Widget with the New Visibility Rules](/web/set-who-can-see-your-widget).

![](/images/4b/Whatfix_Guidance_Db_Click_Who_Rules-4bbc37c2.png)
8\. Click **Save**.

![](/images/61/Mirror_DB_Guidance_Click_Save-61addf0d.png)

> [!WARNING]
>
> To display the Pop-up on your Mirror simulation, you must move both the Pop-up and the Mirror simulation from the **Draft** stage to the **Production** stage before you share them with your learners. Publish the Pop-up on the Whatfix Guidance Dashboard and the Mirror simulation on the Whatfix Mirror Dashboard.
>
> For more information, see [Publish all Whatfix content and widgets to Production](/web/pushing-whatfix-content-to-production) and [Publish Whatfix Mirror](/mirror/publish-whatfix-mirror).

A replica of an application screen captured based on a UI element.

Whatfix Studio is a browser plug-in that enables you to create various types of Whatfix content, such as Flows, Smart Tips, Beacons, and so on. The plug-in can be installed on Google Chrome and the new Microsoft Edge browsers.
