humanmade / popup
An exit intent popup block that shows when someone may be about to leave the site
Installs: 3 645
Dependents: 0
Suggesters: 0
Security: 0
Stars: 13
Watchers: 12
Forks: 1
Open Issues: 0
Language:JavaScript
Type:wordpress-plugin
pkg:composer/humanmade/popup
Requires
- composer/installers: ^1 || ^2
This package is auto-updated.
Last update: 2026-02-18 22:27:02 UTC
README
A lightweight, modern popup block for WordPress that displays any content as a modal dialog.
Features
Trigger Modes
- Click trigger - Open popup from any link or button by setting the URL to
#your-popup-id - Exit intent - Automatically show popup when user moves cursor to leave the page
Display Styles
- Centered modal - Default full-screen overlay with centered content
- Left sidebar - Slide-in panel from the left edge
- Right sidebar - Slide-in panel from the right edge
Anchor Positioning
Position popups relative to their trigger button using CSS anchor positioning:
- Bottom / Bottom Start / Bottom End
- Top / Top Start / Top End
- Left / Left Start / Left End
- Right / Right Start / Right End
Anchored popups automatically reposition when they would overflow the viewport.
Styling Options
- Customizable backdrop opacity (0-100%)
- Backdrop background color support
- Backdrop background image support
- Full layout controls for popup content width
Accessibility
- Built on native HTML
<dialog>element - Keyboard accessible (Escape to close)
- Click backdrop to close
- Add close buttons with
#closeURL
Usage
- Add a Popup Block to your page
- Set an anchor/ID for the popup (e.g.,
my-popup) - Add your content inside the popup
- Create a button or link with URL
#my-popupto trigger it
Exit Intent Popup
- Add a Popup Block and set trigger to "On exit intent"
- Configure cookie expiration (days before showing again)
- The popup will appear when users move to leave the page
Anchored Popup
- Add a Popup Block with click trigger
- Enable "Use Anchoring" in block settings
- Select anchor position (bottom, top, left, right, etc.)
- The popup will appear attached to the trigger button
Requirements
- WordPress 6.1+
- PHP 7.0+
License
GPL-2.0-or-later