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

# Create a Pop-up

Pop-ups focus your users' attention on something that needs their immediate attention as soon as they go to a particular page on your mirrored application. Attach a Flow, video, image, or GIF to the Pop-up. Create Pop-ups on Mirror to send timely notifications and updates to your users.

Pop-up creation is a two-step process: [Step 1: Create the Pop-up using the Visual Editor](https://support.whatfix.com/mirror/docs/creating-pop-ups#step-1-create-the-popup-using-the-visual-editor) [Step 2: Configure the Pop-up Visibility Rules](https://support.whatfix.com/mirror/docs/creating-pop-ups#step-2-configure-the-popup-visibility-rules)

## Step 1: Create the Pop-up using the Visual Editor

Create a Pop-up using any of the following two ways:

- Pop-up creation using Visual Editor through Whatfix Studio
- Pop-up creation using Visual Editor through the Whatfix Dashboard

  Pop-up Creation using the Visual Editor through Whatfix Studio

The Visual Editor enables you to design and customize the components in Whatfix Pop-ups easily, eliminating the need for code editing. With the Drag-and-Drop feature, content creators can resize Pop-ups, add or delete components, and add customizations directly in the UI.

Use the following steps to create a Pop-up using the Visual Editor through Whatfix Studio:

1. Log in to the application where you want to create content, and then launch **Whatfix Studio**. ![CLM\_editor plug in2](/images/f6/CLM_editor-plug-in-2-f67cdef9.png)
2. On the Whatfix Studio, click **Popup**. ![clm\_studio\_pop-up](/images/35/clm_studio_pop-up-35671384.png)
3. Choose the color theme using the **Theme** dropdown. ![2024-10-18\_16-49-43.png](/images/f5/2024-10-18_16-49-43-1-f5099a90.png)

   Note:

Use custom color by entering the hex color code in the text box. ![Add hex color code for Pop-ups before you select a template](/images/c5/Studio_Pop-ups_hexcolor_code-c5c40d28.png)

1. Select a template, for example **Feature Onboarding**. ![Select\_popup\_template](/images/a2/Select_popup_template-a2e7ac05.png)
2. Enter a name for the Pop-up segment. ![Enter\_popup\_segment](/images/00/Enter_popup_segment_name-00d412e6.png)
3. On the Pop-up template, edit the **Title** and **Description** for your Pop-up. ![Edit\_Popup\_Title](/images/2b/Screenshot-2024-07-05-at-8.58.17-AM-2b652d6e.png)

   your title goes here

To customize and align the text, hover your cursor over any text and then double-click to open the **Rich Text Editor**.

For more information on Rich Text Editor, see [Add Rich Text Content Inside a Pop-up using the Visual Editor.](/web/adding-rich-text-content-inside-a-pop-up)

1. On the Pop-up template, edit the **Button Name** for your Pop-up.

![Pop-up button text](/images/aa/Screenshot-2024-07-05-at-9.04.37-AM-aace9c2f.png)

your title goes here

To customize the Button text, hover your cursor over any text and then double-click to open the Rich Text Editor. ![Button\_RTE](/images/9c/Screenshot-2024-07-05-at-9.08.48-AM-2-9c66b9cb.png)

1. To change the button configurations, hover your cursor over the button, and then click to open the button configuration menu. ![Button\_configurations](/images/05/Screenshot-2024-07-05-at-9.10.27-AM-050b6b31.png)
2. Click the dropdown next to **Action**, and then select the button action. ![Button\_action](/images/ef/Screenshot-2024-07-05-at-9.13.43-AM-1-ef86236a.png)

The following table lists the different types of Button Action, their behaviors and descriptions:

| Button Action  | Behavior                                                                                                                                                                 |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Start Flow** | When the user clicks this button, they are taken to a Whatfix Flow that is attached to the button.                                                                       |
| **Attach URL** | When the user clicks this button, they are taken to the URL that is attached to the button.                                                                              |
| **Skip**       | When the user clicks this button, the particular Pop-up is omitted and they continue to see the Pop-up until they click the **Close** or **Don't show me again** button. |
| **Close**      | When the user clicks this button, they close the particular Pop-up.                                                                                                      |

your title goes here

Additionally, make the following changes in the button configuration menu:

- Change the button **Type** to **Primary Button** or **Secondary Button**.

![Button\_Type](/images/2d/Button_Type-2d90e087.png)

- Click the **Button Style** icon to change the **Color**, **Hover color**, and **Corner radius** of the button.

![Button\_config](/images/62/Button_config-6222862c.png)

- Click the **Button Resize** icon to resize the button.

![Button\_resize](/images/ae/Button_resize-ae70ce88.png)

- Click the **Horizontal Align** icon to align the button horizontally.

![Horizontal Align](/images/e9/Horizontal-Align-e9cb82a3.png)

- Click the **Vertical Align** icon to align the button vertically.

![Vertical Align](/images/cc/Vertical-Align-cc1e884b.png)

1. On the Rich Text Editor, click the **+** icon. The **Add Component** dialog box opens. ![Add\_component](/images/45/Screenshot-2024-07-05-at-2.55.51-PM-459e56a8.png)
2. Using **Add Component**, add **Text**, **Button**, **Image/GIF**, **Video**, and **Audio** to the Pop-up. ![open\_add\_component](/images/6f/open_add_component-6f8d8ad3.png)

   Note

- Add up to 24 components to the Pop-Up, using the **Add Component** tab.

![Add component2](/images/02/Add-component-2-021f43cb.png)

- The Pop-Up follows a structured grid layout, with a 6x4 configuration that is 6 rows and 4 columns.

- The Visual Editor supports a maximum of 6 rows and 4 columns that is 24 components in the Pop-up template.

  your title goes here

- Using the **Drag and Drop** feature, move or re-position different components on the Pop-up, both vertically (row-wise) and horizontally (column-wise).

- Each component has two Drag Handlers, the Horizontal Drag Handler and the Vertical Drag Handler for moving the component.

![Drag Handlers](/images/2e/Drag-Handlers-2ed9e7e2.png)

your title goes here

When you make changes to the Pop-up using the Drag Handlers, you may unfortunately not be able to undo certain changes. In that case, you may need to re-create the Pop-up. For more information, see [Can I undo the changes made with the Drag Handlers?](/web/can-i-undo-changes-made-with-the-drag-handlers).

1. Under **CONTROL**, choose if you want to show the **'x' icon on the Popup** and **Don't show me again** checkbox by enabling the toggles.

![control\_panel.png](/images/9e/control_panel-1-9e8fd678.png)

your title goes here

The following table lists the different types of Button Behavior and descriptions that can be added to a Pop-up:

| Button                       | Behavior                                                                                              | Example: A Pop-up is set to display twice                                                                                                      |
| ---------------------------- | ----------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Close button or "X" icon** | Clicking either of these buttons closes the Pop-up and the display is counted as one view             | A user who clicks **Close** and exits the Pop-up will see the Pop-up again based on the its display count.                                     |
| **Don't show me again**      | The user clicks the check-box to make sure the Pop-up never appears again. The count reduces to zero. | A user who clicks the **Don't show me again** check-box will never see the Pop-up again. It does not matter if the count has not been reached. |

your title goes here

- To change the **Pop-up Background Color**, choose the color from the existing color palette or enter the hex code of the desired color. ![under\_control\_click](/images/8b/under_control_click-8b798d61.png)
- To add a **Pop-up Background Image**, click **Upload image**. ![click\_upload\_image](/images/ec/click_upload_image-ec8b993f.png)
- Paste the embed URL of the image you want to insert or upload an image from your local drive or Whatfix Gallery. ![click\_upload\_img](/images/c2/click_upload_img-c2592ce2.png)
- Only .jpg, and .png image formats that are up to 4 MB in size are supported.

1. To configure the Pop-up position, enable the **Position Popup** toggle.

![position\_popup](/images/da/position_popup-da8bdd18.png)

your title goes here

- By default, the Pop-up appears at the center of the page, and end users can not interact with other elements on the application as long as they close or interact with the Pop-up.
- If you enable the Position-Pop toggle, your end users will also be able to interact with other elements on your application.

1. Set the **Position** of the Pop-up. ![set\_position\_popup](/images/bc/set_position_popup-bcee2a23.png)
2. Click **Save Popup**. ![click\_save\_popup](/images/13/click_save_popup-13b93591.png)

   Pop-up Creation using Visual Editor through the Dashboard

Use the following steps to create Pop-ups using the Dashboard:

1. On the Whatfix Guidance dashboard, click **Widgets**. ![ia\_left\_nav\_widgets](/images/d4/ia_left_nav_widgets-d468b7f8.png)

2. Click **Pop-ups**. ![ia\_widget\_popups](/images/f2/ia_widget_popups-f2f9e0ad.png)

3. Click **Create widget**. ![CLM\_DB\_CreateWidget.png](/images/cf/CLM_DB_CreateWidget-cf6933bb.png)

4. Click **Pop Up**. ![CLM\_DB\_Pop-up](/images/d9/CLM_DB_Pop-up-d951cb41.png)

5. Choose the color theme using the **Theme** dropdown. ![RB\_DB\_selectthemes](/images/f4/RB_DB_selectthemes-f475f101.png)

   your title goes here

Use your custom color by entering the hex color code in the text box.

1. Select the Pop-up template.
2. Enter a name for the Pop-up segment by clicking the **Untitled Pop-up** text on top. ![Edit\_popup\_text](/images/ab/Screenshot-2024-07-05-at-10.10.01-AM-abec0ed0.png)
3. Edit the **Title, Description**, and the **Button Name**. ![Edit\_Popup\_Title](/images/2b/Screenshot-2024-07-05-at-8.58.17-AM-2b652d6e.png)

   your title goes here

To customize and align the text, hover your cursor over any text and then double-click to open the **Rich Text Editor**.

For more information on Rich Text Editor, see [Add Rich Text Content Inside a Pop-up using the Visual Editor.](/web/adding-rich-text-content-inside-a-pop-up)

1. On the Pop-up template, edit the **Button Name** for your Pop-up.

![Pop-up button text](/images/aa/Screenshot-2024-07-05-at-9.04.37-AM-aace9c2f.png)

your title goes here

To customize the Button text, hover your cursor over any text and then double-click to open the Rich Text Editor. ![Button\_RTE](/images/9c/Screenshot-2024-07-05-at-9.08.48-AM-2-9c66b9cb.png)

1. To change the button configurations, hover your cursor over the button, and then click to open the button configuration menu. ![Button\_configurations](/images/05/Screenshot-2024-07-05-at-9.10.27-AM-050b6b31.png)
2. Click the dropdown next to **Action**, and then select the button action. ![Button\_action](/images/ef/Screenshot-2024-07-05-at-9.13.43-AM-1-ef86236a.png)

| Button Action  | Behavior                                                                                                                                                    |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Start Flow** | When the user clicks this button, they are taken to a Whatfix Flow that is attached to the button.                                                          |
| **Attach URL** | When the user clicks the button, they are taken to the URL that is attached to the button.                                                                  |
| **Skip**       | When the user clicks this button, they skip the particular Pop-up and continue to see the Pop-up until they click the close or do not show me again button. |
| **Close**      | When the user clicks this button, they close the particular Pop-up.                                                                                         |

your title goes here

Additionally, make the following changes in the button configuration menu:

- Change the button **Type** to **Primary Button** or **Secondary Button**.

![Button\_Type](/images/2d/Button_Type-2d90e087.png)

- Click the **Button Style** icon to change the **Color**, **Hover color**, and **Corner radius** of the button.

![Button\_config](/images/62/Button_config-6222862c.png)

- Click the **Button Resize** icon to resize the button.

![Button\_resize](/images/ae/Button_resize-ae70ce88.png)

- Click the **Horizontal Align** icon to align the button horizontally.

![Horizontal Align](/images/e9/Horizontal-Align-e9cb82a3.png)

- Click the **Vertical Align** icon to align the button vertically.

![Vertical Align](/images/cc/Vertical-Align-cc1e884b.png)

1. On the Rich Text Editor, click the **+** icon. The **Add Component** dialog box opens. ![click\_add\_component](/images/ae/click_add_component-ae7dde8a.png)
2. Using **Add Component**, add **Text**, **Button**, **Image/GIF**, **Video**, and **Audio** to the Pop-up. ![open\_add\_component](/images/6f/open_add_component-6f8d8ad3.png)

   Note

- Add up to 24 components to the Pop-Up, using the **Add Component** tab.

![Add component2](/images/02/Add-component-2-021f43cb.png)

- The Pop-Up follows a structured grid layout, with a 6x4 configuration that is 6 rows and 4 columns.

- The Visual Editor supports a maximum of 6 rows and 4 columns that is 24 components in the Pop-up template.

  your title goes here

- Using the **Drag and Drop** feature, move or re-position different components on the Pop-up, both vertically (row-wise) and horizontally (column-wise).

- Each component has two Drag Handlers, the Horizontal Drag Handler and the Vertical Drag Handler for moving the component.

![Drag Handlers](/images/2e/Drag-Handlers-2ed9e7e2.png)

your title goes here

When you make changes to the Pop-up using the Drag Handlers, you may unfortunately not be able to undo certain changes. In that case, you may need to re-create the Pop-up. For more information, see [Can I undo the changes made with the Drag Handlers?](/web/can-i-undo-changes-made-with-the-drag-handlers).

1. Choose if you want to show the **X icon on popup** and **Don't show me again** options by enabling the respective toggles under **Controls**.

![Controls\_toggles](/images/c6/Screenshot-2024-07-05-at-10.16.14-AM-c63130d7.png)

your title goes here

| Button                       | Behavior                                                                                                 | Example: A Pop-up is set to display twice                                                                                             |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Close button or "X" icon** | Clicking either of these buttons closes the Pop-up and the display is counted as one view                | A user who clicks Close and exits the Pop-up will see the Pop-up again based on its display count.                                    |
| **Don't show me again**      | The user clicks the check-box to make sure the Pop-up never appears again. The count is reduced to zero. | A user who clicks the Don't show me again check-box never see the Pop-up again. It does not matter if the count has not been reached. |

your title goes here

- To change the **Pop-up Background Color**, choose the color from the existing color palette or enter the hex code of the desired color. ![Background\_color](/images/4e/Screenshot-2024-07-05-at-10.18.40-AM-4e6e965e.png)
- To add a **Pop-up Background Image**, click **Upload image**. ![Click\_upload\_image](/images/81/Screenshot-2024-07-05-at-10.22.47-AM-8194b76d.png)
- Paste the embed URL of the image you want to insert or upload an image from your local drive or Whatfix Gallery. ![click\_upload\_img](/images/c2/click_upload_img-c2592ce2.png)
- Only .jpg, and .png image formats that are up to 4 MB in size are supported.

1. To configure the Pop-up position, enable the **Position Popup** toggle.

![Popup\_position](/images/4a/Screenshot-2024-07-05-at-10.25.20-AM-4af02f62.png)

your title goes here

- By default, the Pop-up appears at the center of the page, and end users can not interact with other elements on the application as long as they close/interact with the Pop-up.
- If you enable the Position-Pop toggle, your end users will also be able to interact with other elements on your application.

1. Set the position of the Pop-up.

![Configure\_popup\_position](/images/1b/Screenshot-2024-07-05-at-10.26.36-AM-1b30f7cf.png)

Note

If your end user is using a mobile browser, then even if you have enabled the **Position Popup** toggle and configured the Pop-up position, your end user sees the Pop-up at the center of the page. This happens because of the limited screen space on mobile browsers.

1. Click **Save** to save the Pop-up, or continue configuring the Pop-up.

![RB\_DB\_clicksave](/images/17/RB_DB_clicksave-175bf20f.png)

## Step 2: Configure the Pop-up Visibility Rules

Configure the Pop-up Visibility Rules

Use the following steps to configure a Pop-up:

1. On the Whatfix Guidance dashboard, click **Widgets**. ![ia\_left\_nav\_widgets](/images/d4/ia_left_nav_widgets-d468b7f8.png)

2. Click **Pop-ups**. ![ia\_widget\_popups](/images/f2/ia_widget_popups-f2f9e0ad.png)

3. Hover your cursor over the Pop-up segment you want to configure, and then click the **Edit** icon. ![CLM\_DB\_Click\_edit\_icon.png](/images/7f/CLM_DB_Click_edit_icon-7f5dddac.png)

4. Click **Set Visibility Rules →**. ![RB\_DB\_setvisirulespopup](/images/8c/RB_DB_setvisirulespopup-8c4fb036.png)

5. Set the **Where** [Visibility Rules](/desktop/visibility-and-display-rule-conditions) for the Pop-up to appear. ![RB\_DB\_popupwhererules](/images/a0/RB_DB_popupwhererules-a058e01a.png)

   your title goes here

If you have configured multiple Pop-ups with different Visibility Rules to appear on the same page, the Pop-up configured with **User Action Completed** as the Visibility Rule is always shown first when the end user performs the User Action.

1. Set the **When** Visibility Rules for the Pop-up. See, [Schedule Pop-ups](/web/scheduling-pop-ups)

![RB\_DB\_whenrulespopup](/images/1a/RB_DB_whenrulespopup-1a116d11.png)

your title goes here

If the Pop-up has a Skip button and when your end users click the Skip button, it is not considered as an interaction and the Pop-up will be displayed to them regardless of the occurrences you have set.

1. Click **Finish later** or **Edit Popup** depending on your preference.

![RB\_DB\_popupfinishlater](/images/5d/RB_DB_popupfinishlater-5decca00.png)

- **Finish later**: Saves the Pop-up as Draft and marks it as Inactive.
- **Edit Pop-up**: Takes you back to the Pop-up where you can make changes.

1. Once you are done creating the pop-up, select the widget, and then click **Send to ready**. ![clm\_db\_send\_to\_ready](/images/d7/clm_db_send_to_ready-d7da176a.png)
2. Go to the **Ready** Stage and select the segment you want to move to Production Stage, and then click **Push to production**. ![clm\_db\_push\_to\_production](/images/3d/clm_db_push_to_production-3ddfb583.png)

   your title goes here

After pushing the Pop-up to Production, analyze the engagement of end users with the Pop-up from different cities, countries, and more, using Product Analytics. For more information, see [How can I see analytics of Pop-ups using Trend Insights?](/analytics/how-can-i-see-analytics-of-pop-ups-using-trend-insights)

Note:

If you're using the [JS Embed method](/web/integrating-whatfix-using-javascript) to test or publish Whatfix content, add the relevant conditions in Map Stages. This ensures that the content appears in the correct instance. For more information, see [How to add conditions in Map Stages?](/web/how-are-the-visibility-rules-evaluated-while-mapping-stages) (Log in to see the article)

The Whatfix Rich Text Editor enables you to format content using multiple options. It also enables you to link and include multimedia content.

![](/images/bf/image-1720150380939-bf712686.png)

The primary button is associated with a positive user action based on the Pop-up's contents. For example, trigger a flow or open a URL.

The Secondary Button is used to close or dismiss the Pop-up without triggering any specific action.

Drag Handlers are used to move or reposition the component within the Pop-up.

Use the Horizontal Drag Handler to move the component horizontally (column-wise).

![](/images/8d/Horizontal_DH-8de891fe.png)

Use the Vertical Drag Handler to move the component vertically (column-wise).

![](/images/4d/use-vertical-drag-handler-4dc9663f.png)
