Documentation

Learn Simple Popup Everywhere

Everything you need to install the plugin, build your first popup and get the most out of Pro.

Getting started

Simple Popup Everywhere lets you build popups with the editor you already use – the WordPress Block Editor or Elementor – and show them anywhere on your site.

Requirements

  • WordPress 6.9 or newer
  • PHP 7.4 or newer
  • Elementor (free) – only if you want to design popups with Elementor

Install the free plugin

  1. In your dashboard, go to Plugins → Add New.
  2. Search for GazzIT Simple Popup Everywhere.
  3. Click Install Now, then Activate.

You’ll find a new Simple Popup menu in your dashboard. You can also download the plugin from WordPress.org.


Installing Pro

  1. Make sure the free plugin is installed and active.
  2. Download the Pro zip from My account → Licenses.
  3. Go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now, then Activate.
  4. Go to Simple Popup → Pro License, paste your license key and click Activate license.

Your license key is in your order confirmation email and in your account under Licenses. Updates for Pro then appear on the normal WordPress Dashboard → Updates screen.


Popups with the Block Editor

  1. Go to Simple Popup → Add New.
  2. Give the popup a title (only you see it) and build the content with any blocks – headings, images, buttons, or shortcodes and blocks from form plugins.
  3. Open the Simple popup settings panel to choose where and how often it shows, the delay, the close button and the style.
  4. Click Publish.

Popups with Elementor

  1. Go to Simple Popup → Add New and click Edit with Elementor.
  2. Design the popup with any Elementor widgets.
  3. Open the page settings (the gear icon) to configure the popup: position, frequency, delay, close button and box styling. Pro settings are under Settings → Popup settings (Pro).
  4. Click Publish.

The free version of Elementor is enough – Elementor Pro is not required.


Displaying a popup

There are three ways to show a popup:

  • Site-wide: set Show on to Every page.
  • Shortcode: copy the shortcode shown in the popup list, e.g. [gazzit-simplepopup id="123"], into any post, page or widget area.
  • Elementor widget: drag the Simple Popup widget onto a page and pick a popup. You can override its look and timing just for that placement.

Tip: while logged in, use Edit Simple Popups in the admin toolbar to jump straight to the popups shown on the current page.


Popup settings

  • Show on – Only where placed (shortcode or widget) or Every page.
  • Show popup – on every page load, or once per visitor for a day, week, month, year or forever. This is remembered in the visitor’s browser only – no cookies.
  • Show delay – seconds to wait before the popup appears.
  • Close on overlay click – whether clicking the dark background closes the popup.
  • Close button – text or icon, left or right, with its own colors and hover state.
  • Popup box – width, padding, corner radius, background, overlay color and border, in the Block Editor sidebar and in Elementor (Elementor also has margin).
  • Your own close buttons – give any button or link in the popup the CSS class gsp-close and clicking it closes the popup, e.g. for a “No thanks” button.
  • Style preset – one of five ready-made styles, or your own (see below).

Visitors can always close a popup with the Escape key, and keyboard focus moves into the popup and back out again.


Popup templates (Pro)

Start a popup from one of 10 ready-made designs instead of a blank page: newsletter discount, coupon code, opening hours, product of the day, webinar, video, age verification, review request, free guide and holiday sale. With Elementor Pro active you also get 2 form templates (newsletter form and contact form) in Elementor.

  1. Go to Simple Popup → Add New. For a new, empty popup the template picker opens automatically.
  2. To open it later: in the Block Editor use the Popup templates button in the Simple popup settings box or the editor’s ⋮ menu; in Elementor click the orange templates button next to + on the canvas.
  3. Pick a template and click Insert.
  4. Change the texts, links and images, then click Publish.

A template replaces the popup’s content and its look: width, background, overlay, padding, corner radius, close button and position. Display settings such as Show on, frequency and delay are not changed. If the popup already has content, you are asked before anything is replaced.

Template images are copied to your Media Library the first time you use them, so your popup never depends on the plugin’s files.

Block Editor templates need WordPress 7.0 or newer and the free plugin 1.7.0 or newer. Inserting a template needs an active license.


Scheduling (Pro)

Show a popup only during a chosen period – for example a sale weekend.

  1. Open the popup and go to Popup settings (Pro) (Block Editor sidebar box, or Settings tab in Elementor).
  2. Set a start date/time, an end date/time, or both. Leave one empty for “from now on” or “until”.
  3. Update the popup.

Times use your site’s timezone from Settings → General. If you use a page cache, clear it after changing a schedule so cached pages pick up the change.


Click triggers (Pro)

Open a popup when a visitor clicks an element on your site.

  1. Give the element (button, link, image, menu item) a CSS class or ID, e.g. open-offer.
  2. In Popup settings (Pro), enter the selector, e.g. .open-offer. Separate several selectors with commas: .open-offer, #newsletter-button.
  3. Update the popup.

Popups with a click trigger are added to every page automatically, so the trigger works wherever the element appears. In menus, add the CSS class under Appearance → Menus → Screen Options → CSS Classes.


Custom style presets

Add your own preset to the style dropdown from your theme:

  1. Create the folder /gazzit-simplepopup/popup-styles/ in your (child) theme.
  2. Add a CSS file, e.g. my-style.css. The file name is the style’s slug.
  3. Prefix your selectors with .gazzit_simplepopup.popup-style-my-style.
  4. Optionally add a header comment /* Style Name: My Style */ to set the label.

Managing your license

Move a license to another site

On the old site click Deactivate on this site under Simple Popup → Pro License, or deactivate it under My account → Licenses. Then activate the key on the new site.

Staging and local sites

Sites such as localhost, *.local, *.test and staging. subdomains don’t count toward your limit.

When your license expires

Everything you’ve set up keeps working, including popups made from templates. You can’t change the Pro settings or insert new templates, and you won’t get updates until you renew.

Renewing

Use the renewal link in your reminder email or the Renew button in your account. Renewals get 20% off and extend your current license – the key and activated sites stay the same.


Troubleshooting

My popup doesn’t show

  • If it’s set to show once per visitor, you’ve probably already seen it. Open the site in a private window to test.
  • Check that the popup is published and that its position, shortcode or widget is in place.
  • Pro: check the schedule – the popup only shows between the start and end time.
  • Clear your caching plugin or CDN cache.

I don’t see the Pro update

  • Make sure the license is active under Simple Popup → Pro License.
  • Go to Dashboard → Updates and click Check again.

I don’t see the popup templates

  • Update the free plugin to 1.7.0 or newer.
  • Block Editor templates need WordPress 7.0 or newer.
  • The 2 form templates appear only in Elementor, with Elementor Pro active.

Still stuck?

Contact us – include your site address and, for Pro, your license key.

Ready for Pro?

Get ready-made templates, scheduling, click triggers and 12 months of updates – from €29 a year.