Page Load Trigger

The "Page Load" Trigger fires when the whole page has loaded, including all dependent resources such as stylesheets and images. Equivalent to Document.load event. Below you can find how to set up a box with "Page Load" trigger, all supported settings for this trigger explained as well as how to trigger it with the JavaScript Events API.

How to create a Page Load popup in Joomla

To set up your box to trigger on Page Load go to your box > Behavior tab > Trigger section and apply the following settings:

  • Click on Page Load.
  • Set the delay of the trigger by entering a number in milliseconds in the Delay setting.
  • Enable Early Trigger if you want your popup to appear as soon as the page's HTML is loaded in the visitor's browser.

engagebox trigger on page load settings

Trigger Settings

Below you can find all settings that are configurable when you choose the "on Page Load" Trigger.

Setting Value Description
Trigger Page Load Fires when the whole page has loaded
Early Trigger On/Off Enable this option if you wish to trigger the popup as soon as the visitor's browser has loaded the page's HTML.

This will allow you to show your popup even if other page assets are still loading. (images, scripts, audio files, etc.) 
Delay 0 Delay trigger in miliseconds. E.g.: 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 box and attempts to determine the user's intent. It is recommended to use at least 30 ms.

Use Cases

Open box as soon as the page finishes loading

Page Load triggers the popup after the page has completely finished loading, including all assets like images, stylesheets, and scripts. This ensures your page is fully rendered before the popup appears.

Page Load with Early Trigger enabled shows the popup as soon as the DOM is ready (similar to the former Page Ready trigger), before all assets have finished loading. This makes the popup appear faster but doesn't wait for the complete page load.

Use the standard Page Load setting when you want to ensure users see your fully loaded page before any popups appear. Use the Early Trigger option when you want faster popup display and don't need to wait for all page assets to load.

Frequently Asked Questions

How to Trigger using Javascript

Using the Javascript Events API v2, you can configure any box to be triggered using the "on Page Load" Trigger. Below you can find a Javascript snippet:

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

    box.bindTrigger('onPageLoad');
});

You can read more on the Javascript Events API documentation, on Page Load Trigger.

Last updated on Sep 1st 2025 14:09