Element Visibility Trigger

The "Element Visibility" Trigger fires when specified element(s) enters the viewport after scroll down. If the specified scroll depth is visible in the viewport when the page loads, the trigger will fire without a scroll occurring. Below you can find how to set up a popup with "Element Visibility" trigger, all supported settings for this trigger explained as well as how to trigger it with the JavaScript Events API.

How to create a popup that appears when an element becomes visible in WordPress

To set up your campaign to trigger Element Visibility go to your campaign settings Format Panel and apply the following settings:

• Select Element Visibility from the Trigger setting.
• Set the Trigger Element by specifying the ID or the Class of the element(s) that should fire this trigger. You can specify multiple elements separated by comma.
• Set the percentage of the triggered element that must be visible in order for the trigger to fire, in the Min Percent Visible setting.
• Set whether to close the popup when the triggered element is outside the viewport in the Close Outside Viewport setting.
• Set whether to fire the trigger once or unlimited times on the Firing Frequency setting.
• Lastly, set the delay of the trigger by entering a number in milliseconds in the Delay setting

Trigger Settings

Below you can find all settings that are configurable when you choose the "Element Visibility" Trigger.

Setting	Value	Description
Trigger	Element Visibility	Fires when the specified element enters the viewport after scroll down
Trigger Element	.item-1, .item-2	Specify the ID or the Class of the element(s) that should fire this trigger. You can specify multiple elements separated by comma. Example 1: .item-100, .item-101 Example 2: #logo Keep in mind that query selectors must always begin with an underscore (_), a hyphen (-), or a letter(a–z), followed by any number of hyphens, underscores, letters, or numbers.
Min Percent Visible	0	Specify how much of the selected element must be visible on screen before the trigger fires. A value of 25 means that the trigger will fire when 25% of the element is visible while a value of 100 will fire the trigger when the element becomes fully (100%) visible.
Close Outside Viewport	Disabled	Automatically close the popup when it is outside of the viewport. It respects the Minimum Percent Visible option.
Show Once Per Page	Enabled	Configure the fire frequency of this trigger per page. Enabled: The trigger will fire only once per page. Disabled: The trigger will fire whenever the event occurs on the page.
Delay	0	Delay trigger in miliseconds. Leave 0 for immediate execution or enter 2000 for 2 seconds delay. If the trigger point is set to onElementHover then this value is used to delay or prevent the accidental firing of the popup and attempts to determine the user's intent. It is recommended to use at least 30 ms.

Use Cases

Open popup once user has started scrolling over a specific element on your page

A use case for this would be when you have a specific element on your page that you want to display the popup only when your users scroll on your page and find the element you specified on your popup settings which will trigger the popup to appear. As your user keep scrolling, the popup can also be closed automatically.

Open popup once user has scrolled over a specific element on your page

This use case works the same as the one above but requires the element to be fully visible to your user before the popup can appear.

Open popup when page loads and user is viewing a specific element

The "Element Visibility" trigger also displays a popup when you load a page and you are viewing the specified element without trigger a scroll. This will display the popup as soon as the page finishes loading.

Frequently Asked Questions

How to Trigger using Javascript

Using the Javascript Events API, you can configure any popup to be triggered using the "Element Visibility" Trigger. Below you can find a Javascript snippet:

FireBox.onReady(function() {
    // Get box instance
    const box = FireBox.getInstance(5);

    box.bindTrigger('onElementVisibility', {
        trigger_selector: '.myButton', 
        threshold: 0.8 // 80% percent,
        close_out_viewport: true
    });
});

You can read more on the Javascript Events API documentation, Element Visibility Trigger.