Source: https://nishanth-fern-test.docs-staging.pageloop.ai/desktop/pop-up

# Create Pop-Ups

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

Create a Pop-up in 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. On the Whatfix Studio, click **Popup**. ![clm\_studio\_pop-up](/images/35/clm_studio_pop-up-35671384.png)
2. Choose the color theme using the **Theme** dropdown. ![RB\_EDT\_popupthemes](/images/a5/RB_EDT_popupthemes-a58cc1a2.png)

> [!WARNING]
>
> Use your custom color by entering the hex color code in the text box.

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)

> [!INFO]
>
> 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 content in a pop-up using the rich text editor](/desktop/adding-content-inside-a-pop-up-using-rich-text-editor).

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)

> [!INFO]
>
> 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.                                                                                                      |

> [!INFO]
>
> 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)

> [!WARNING]
>
> - 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.

> [!INFO]
>
> - 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)

> [!WARNING]
>
> 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?](/desktop/can-i-undo-the-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)

> [!WARNING]
>
> 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. |

> [!INFO]
>
> - 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.

2. To configure the Pop-up position, enable the **Position Popup** toggle. ![position\_popup](/images/da/position_popup-da8bdd18.png)

> [!INFO]
>
> - 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)

> [!WARNING]
>
> 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)

> [!INFO]
>
> 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 content in a pop-up using the rich text editor](/desktop/adding-content-inside-a-pop-up-using-rich-text-editor)

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)

> [!INFO]
>
> 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.                                                                                         |

> [!INFO]
>
> 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)

> [!WARNING]
>
> - 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.

> [!INFO]
>
> - 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)

> [!WARNING]
>
> 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?](/desktop/can-i-undo-the-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)

> [!WARNING]
>
> | 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. |

> [!INFO]
>
> - 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)

> [!WARNING]
>
> - 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)

> [!WARNING]
>
> 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)

> [!INFO]
>
> 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](/desktop/schedulingpop-ups). ![RB\_DB\_whenrulespopup](/images/1a/RB_DB_whenrulespopup-1a116d11.png)

> [!WARNING]
>
> 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)

> [!INFO]
>
> 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 [Trend Insights](/analytics/how-can-i-see-analytics-of-pop-ups-using-trend-insights).

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)
