Popsy Documentation

Overview

Grow your email list with a beautiful popup or slide-in: a welcome discount revealed after subscribing, smart triggers, consent and CSV export.

• Turn visitors into subscribers
• Welcome code revealed after signing up
• Polite timing: delay, scroll or exit intent

Best for: Stores and blogs building an email list

Installation

1. Download popsy-email-popup.zip from My account › My plugins or from your order email. Do not unzip it.
2. In WordPress, go to Plugins › Add New Plugin › Upload Plugin, choose the zip and click Install Now, then Activate.
3. Click "Preview on the site", then tick "Show the popup to visitors" and save.

Requires WordPress 6.0+, PHP 7.4+. Works with any theme, block themes and page builders.

Features

• Centered popup or less intrusive slide-in, optional image, your accent color and texts
• Welcome discount code revealed only after subscribing (never in the page source), with a "click to copy" button
• Triggers: after X seconds, after scrolling X% of the page, exit intent on computers
• Frequency: shown again only after X days when closed; never again after subscribing
• Phones and/or computers; never on cart, checkout and account pages; exclude pages by ID
• Required consent checkbox, consent date saved with each subscriber
• Subscribers list and CSV export, ready to import into Brevo, Mailchimp, MailerLite…
• Optional email notification for each new subscriber
• Works on cached pages (no expiring security token), spam protection with honeypot and rate limiting
• Accessible dialog: focus kept inside, Escape to close, focus returned, reduced motion respected
• Preview link to check the design before enabling it
• `popsy_subscribed` action for developers (send to your newsletter tool)
• Lightweight: no jQuery on the front end, no external service, no tracking
• Translation-ready

For developers

Customize the plugin from your theme’s functions.php or a small plugin, without editing its files (your changes survive updates).

Filters

• popsy_show

add_filter( 'popsy_show', function ( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Actions

• popsy_subscribed

Updates

Updates are free. When a new version is out, it appears in Dashboard › Updates of your WordPress site and you can install it in one click, or turn on automatic updates in Plugins. This works for the zip downloaded from your Woo-Plugins account; older copies can be replaced by downloading the latest version from My plugins. See the changelog.

Frequently asked questions