Webflow Modals & Popups Auto-Open and Auto-Close

Automatically show or hide your Webflow modals, popups & more after the user closes them for a specified number of days.



  • Timed open, in ms

    • Auto unhide

    • Or, click trigger, for interaction

    • Respects suppression setting

  • Triggered open, by scroll

  • Triggered open, by exit intent

  • Timed close, in ms

    • Element removal

    • Or, click trigger, for interaction

    • ? Option to suppress

This feature enables you to easily "close" and suppress UI elements so that they will not appear for a specified number of days, even on page reload.

It's primarily used for;

  • Alert banners

  • Notices

  • Modals & pop-ups

But can be used for any elements that you want to suppress.


Use Cases

  • Suppress an interactions-based modal popup

  • Suppress a CTA or other banner

Usage Notes

This library simplifies modal design into two parts-

  1. The modal element itself, which can be any popup, DIV, or other element

  2. Close button element(s). These must be positioned within the modal element as descendants.

To implement this, build your modals or CTAs however you like.

The close functionality will be an element with a special custom attribute on it. When closed, SA5 will remove the element from the DOM, and suppress it for as long as you've requested.

In Webflow, modals are commonly "closed" using an interaction. It may include fade-out, slide-out, or spin-off-screen effects. SA5 simply deletes the element outright, so those exit animations would not be seen, the modal will simply disappear.

Add the SA5 Library

First, add the library as detailed in Quick Start.

I want this element to represent my suppressible content

To the outermost element you want to suppress;

  • Add a custom attribute of wfu-modal = ( name ). Give it any custom name you like. That name will be used in the suppression tracking so you can e.g. have the same modal on every page, and suppress it site-wide.

This name must be unique.

Multiple triggers ( scroll hover, exit, etc? )

wfu-modal-trigger = load | click | scroll | hover | exit | timer

Modal triggers display the modal element and fall into two categories - automatic triggers and element triggers.

Automatic triggers occur due to some system event, and are always configured on the modal element directly. These include;

  • load triggers immediately on page load

  • timer triggers fire after a specified delay

  • scroll triggers fire at a % of page scrolled

  • exit triggers fire on an exit intent

Element triggers occur in relation to another element on the page, and are configured on that element;

  • click triggers

  • hover triggers

  • scroll-into-view triggers

Element triggers require an additional attribute of wfu-modal-trigger-target which specifies the name of the modal you are triggering ( as defined by wfu-modal )


OPTIONAL, except...

  • for timer, this is set to ms

  • for scroll, this is set to % of scroll

wfu-modal-trigger-target = ( name )

Used only with element triggers. Specifies the name of the modal you are triggering ( as defined by wfu-modal )

Indicates the target element, for triggers which are on a separate element

click, scroll

  • Add a custom attribute of wfu-modal-trigger = load.

  • Add the suppression duration you want, using wfu-modal-suppress-days = ( days ). If unspecified, defaults to about 1 year.

I want this element to be the close button

To the close element(s) within the modal;

  • Add an attribute of wfu-modal-close = true

  • Add an attribute of wfu-modal-close-type = auto

wfu-modal-close-trigger = click | timer

wfu-modal-close-trigger-config = ms

wfu-modal-close-trigger-target OPTIONAL = ( name )

Can be placed on any element

If placed on an element within the modal, an unspecified target will automatically target the current modal.

wfu-modal-close-method = remove | hide

Questions? Feature Requests?

Visit the SA5 forum link at the top of this page.

Last updated