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

# Create a Carousel Pop-up

The Carousel Pop-up template is designed to help you communicate brief product information in the form of slides that your users can swipe through. Use the carousel Pop-up template to create a sense of curiosity among your users by conveying multiple pieces of information (text, videos, or images) using slides that are compiled together in a single Pop-up.

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

**Create the Carousel Pop-up using Visual Editor**

Use the following steps to create a Carousel Pop-up using the Visual Editor:

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 the **Carousel** template. ![carousel\_pop-up](/images/2f/carousel_pop-up-2f292edb.png)
2. Enter the number of carousel slides you wish to have in your Pop-up, and then click **Create**. ![Studio\_pop-up\_slides](/images/3d/Studio_pop-up_slides-3d7c244d.png)

> [!WARNING]
>
> - Add up to **6 slides** in Carousel Pop-Up using the Visual Editor.
> - Move the slides to the desired positions in the Pop-up by dragging and dropping the slide number.
> - Remove a particular slide by clicking the **X** icon that appears next to the slide number.
> - Since, it is a Carousel Pop-up, it needs to have at least 2 slides. If your Pop-up contains 6 slides, up to 4 slides can be removed.

1. On the Pop-up template, edit the **Title** and **Description** for your Pop-up. ![Edit\_popup\_title](/images/72/Screenshot-2024-07-05-at-2.42.48-PM-725306ec.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. ![Edit\_button\_name](/images/59/Screenshot-2024-07-05-at-2.44.41-PM-593a24c4.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**, you can 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 component(2)](/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. Click the **+** icon to add a new slide to the Carousel Pop-up. ![Add\_new\_slide](/images/f9/Screenshot-2024-07-05-at-2.59.13-PM-f909fce9.png)
2. Under **CONTROL**, choose if you want to show the **'x' icon on the Popup** and **Don't show me again** by enabling the toggles. ![enable\_xicon\_popup](/images/31/enable_xicon_popup-31af12bd.png)
3. Choose if you want to show the **Carousel Dots** and **Carousel Arrows** by enabling/disabling the respective toggles. ![enable\_carousel arrow\_edit.png](/images/81/carousel-arrow_edit-81ee34b6.png)

> [!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, .png, and .gif image formats that are up to 4 MB in size are supported.

1. If you want to configure the Pop-up position, enable the **Position Pop-up** 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 of 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 of your application.

1. Set the **Position** of the Pop-up. ![set\_position\_popup](/images/bc/set_position_popup-bcee2a23.png)
2. Once you are done creating the Pop-up, click **Save Popup**. ![click\_save\_popup](/images/13/click_save_popup-13b93591.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. For more information, 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.
- **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)

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)
