Top

Create Popups with Templates for DAP on OS

Prev Next

Overview

Whatfix enables you to create Popups using a library of ready-to-use templates designed for common use cases such as announcements, alerts, and onboarding.

Select a template that matches your requirement and customize it to your style and design. Templates are visually organized to reduce the time and effort required to create Popups.

Note:

The Popup templates applies to only to new Popup creation. All existing Popups remain unchanged.


Step 1: Select a Template

Expand the following accordions to select a Popup template:

On Whatfix Dashboard

  1. On the Whatfix Guidance dashboard, click Widgets.
    ia_left_nav_widgets

  2. Click Pop-ups.
    ia_widget_popups

  1. Click Create widget.

  2. Click Pop-up.

  3. Select a Template based on your requirement.

Info:

Use the Filter option to filter the templates by Use Case, Type, or Component.

Step 2: Edit the Popup

The Editor is a drag-and-drop workspace with a live preview of the Popup, where you can reorder, resize, add, and remove elements within the Popup boundary.

The following sections describe all the actions you can perform in the Editor:

Resize and reposition elements within the Popup

  • Reposition an element within the Popup: A grab handle appears at the top-centre of the element and is visible on both hover and select. Use it to reposition an element.

    Here’s a GIF that shows how you can use the grab handle to drag and reposition the element:

  • Resize an element within the Popup:

    • Text, video and image components: Use the resize controller in the middle-right side to adjust width only.

      Your title goes here

      • The maximum width of an image component is dynamically constrained by the width of the popup. When you adjust the popup width, the image automatically resizes. The maximum width of an image component is 800 px.

      • When you change the Border Radius of the Popup, the image components appear within the rounded corners.

    • Button component: Resize controllers on the right side and bottom center, allowing both width and height adjustment.

    • The maximum width of an element is constrained by the Popup width. If padding is configured, the effective maximum width becomes the Popup width minus the applied padding.


      Here’s a GIF that shows how you can resize text and button components:


  • Configure the space in between elements: adjust vertical spacing and insert new elements between existing ones. Hover your cursor in between elements, and use theDrag to adjust spacing handle to adjust the space in between elements. Drag the handle up or down to increase or decrease the space between the elements.

    Here’s a GIF that shows how you can adjust the space in between elements:

Resize the Popup

The editor enables you to drag and resize the total size of the Popup. When you resize the Popup, the editor displays the width and height of the Popup, providing a clearer understanding of its size while resizing.

Here’s how you can resize the Popup width and height:

Review and revert changes using Undo and Redo

You can use the Undo and Redo buttons in the editor to quickly revert or reapply changes while editing your popup.

All edit actions performed within the Studio (right panel and editor space) can be undone or redone.

Your title goes here

The following limitations apply when reverting or reapplying changes:

  • Up to 20 actions are supported for Undo and Redo

  • Oldest actions are removed once the limit is reached

  • Redo history is cleared after a new action is performed

  • Undo or Redo history is session-based and does not persist after saving the Popup

  • Navigating away from the editor or refreshing the page clears the history

Add text and elements within a Popup

The Whatfix Rich Text Editor enables you to change font, size, and link multimedia content. Use the + (plus) icon to add elements or components at specific positions within the Popup layout. For more information, see Add Rich Text content inside a Popup.

Here’s how you can add components to the Popup:

Paste text and retain the formatting of the component

Use the following steps to paste text into a text or button component without losing its formatting:

1. Copy the text from its source.

2. In the Editor, select the text you want to replace.

3. Press Cmd + Shift + V on Mac or Ctrl + Shift + V on Windows.

The pasted text keeps the existing formatting of the component.

Note:

If you paste with Cmd + V or Ctrl + V, the pasted text uses the default formatting of the copied text.

Configure Button behaviour in a Popup

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

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

    Button_config

  • Click the Button Resize icon to resize the button.

    Button_resize

  • Click the Horizontal Align icon to align the button horizontally.

    Horizontal Align

  • Click the Vertical Align icon to align the button vertically.

    Vertical Align

Step 3: Configure the Popup

The Whatfix Dashboard enables you to configure the Appearance, Position, and Control for the Popup.

You can configure the following Popup configurations in any order based on your requirements:

  1. In the Appearance section, you can configure the Background, Padding, and Border Radius of the Popup.


    Expand the following section to learn how to configure Appearance for the Popup:

    Configure Background, Padding, and Border Radius

    Background
    Choose between Color or Image:

    • For Color:

      • You can select Solid or Gradient option

      • 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

      • Upload supported formats (such as, PNG, JPG, GIF, or SVG)

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

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

    • Enable Uniform padding to apply the same spacing on all sides

    • 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

    2. 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.

    • 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

    3. In the Control section, you can configure the behavior of the Popup.

Expand the following section to learn about the controls of the Popup:

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

    Note:

    The accessibility feature is not available by default. To enable, contact support@whatfix.com.


Carousel (applicable only for carousel templates)

Your title goes here

This section appears in the Controls accordion only when a carousel template is selected. For more information, see Create 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).

    Your title goes here

    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:

    • Both arrows and markers (displays both left and right arrow marks, and dot indicators)

    • 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.

    Your title goes here

    You can add upto 12 slides in a carousel popup.

  1. Once done, click Save.


Step 4: Set Visibility Rules

To learn how to configure Visibility Rules, refer to Visibility Rule Conditions for Pop-up.


Step 5: Publish the Popup

To learn how to publish Popup, see Publish Whatfix Content.

Privacy Policy | Whatfix Glossary | Whatfix Platform Status
Copyright © 2024 WHATFIX TM. All rights reserved.