How to edit the promo popup

The Promo Popup feature in WoodMart theme allows you to display promotional messages, newsletters, special offers, or announcements to your website visitors through a customizable popup window. The popup can be triggered based on various user interactions and behaviors.

This feature can be found in: Theme Settings → General → Promo popup

Main settings

Enable promo popup

Master switch to enable or disable the promo popup feature on your website. When enabled, the popup will show to users when they enter the site based on your configured trigger conditions.

Content

These settings control what content appears inside your promo popup.

Promo popup content

Choose how you want to create your popup content. HTML Blocks provide more flexibility with page builders (Elementor, WPBakery, Gutenberg) and allow you to create visually rich designs with images, forms, and custom layouts.

Options:

• Text – Use the built-in text editor to create simple popup content
• HTML Block – Use a pre-created HTML Block for more advanced designs (recommended)

Text

Enter your popup text content using the visual editor. You can format text, add links, images, and use shortcodes to enhance your message.

HTML Block

Select a pre-created HTML Block from your library. HTML Blocks should be created beforehand in Theme Settings → HTML Blocks.

This is the recommended method for creating complex popup designs with newsletter forms, promotional images, discount codes, or multi-column layouts.

Style

These settings control the visual appearance of your popup.

Popup background

Set the background image and/or color for your promo popup. You can upload a background image, choose repeat options, set size (cover, contain, auto), and position it to create an attractive popup design.

Popup text color

Set the text color scheme for your popup content. Choose the option that provides the best contrast with your background for optimal readability.

Options:

• Dark – Use dark text for light backgrounds
• Light – Use light text for dark backgrounds

Popup width

Set the width of the promo popup in pixels. You can adjust the width from 400px to 1000px based on your content and design needs.

Popup padding

Control the internal spacing (padding) of the popup content. You can set different padding values for desktop, tablet, and mobile devices to ensure your content looks perfect on all screen sizes.

Tip: Set padding to 0 if your HTML Block already has its own internal spacing to avoid double padding.

Settings

These options control when and how the popup appears to users.

Hide on mobile devices

Enable this option to completely disable the popup on mobile devices (tablets and phones). Useful when your popup design is not optimized for small screens or contains complex forms.

Show popup after

Choose the main trigger method for displaying the popup to users.

Options:

• Some time – Display the popup after a specific time delay from page load
• User scroll – Display the popup when user scrolls to a certain point on the page

Tip: Scroll-based triggers are better for content-heavy pages like blogs, as they target users who are already engaged with your content.

Popup delay

Set how long to wait after the page loads before showing the popup. Enter the value in milliseconds, where 1000ms equals 1 second.

Tip: For blog posts or long-form content, consider 5-8 seconds delay to let users start reading before interrupting them.

Show after user scroll down the page

Set the number of pixels the user must scroll down the page before the popup appears. This ensures users are engaged with your content before seeing the popup.

Show after number of pages visited

Set how many pages a user must visit on your site before the popup is shown. Setting this to 0 will show the popup on the first page visit, while setting it to 1 or higher will wait until the user has explored your site.

Tip: For e-commerce sites, setting this to 2-3 pages helps target shoppers who are actively browsing your catalog rather than showing the popup to everyone who lands on your site.

Popup version

Version control for your popup. When you make significant changes to your popup content or design, increase this number to show the popup again to users who have already closed it previously.

The theme stores a cookie when users close the popup. Changing the version number creates a new cookie, forcing the popup to display again even to users who dismissed it before.

When to update the version:

• You changed the promotional offer (10% OFF to 20% OFF)
• You added a new newsletter incentive (free shipping, free ebook, etc.)
• You completely redesigned the popup
• You switched from one campaign to another

Use this feature sparingly. Showing the same popup repeatedly to users who already dismissed it can be annoying and damage user experience.

How it works

Cookie management

When a user closes the popup, a cookie is stored in their browser that prevents the popup from appearing again. The cookie includes the popup version number in its name, so changing the version number bypasses this restriction. Cookies expire after 7 days by default.

Page view tracking

The theme tracks how many pages a user has visited in the current session using a cookie named woodmart_shown_pages. The popup will only show after the required number of page views is reached, ensuring users are engaged before seeing promotional content.

Manual trigger

Users can also manually open the popup by clicking any element with the class .woodmart-open-newsletter. This is useful for creating custom Subscribe buttons in your header, footer, or sidebar.

This is a legacy feature maintained for backward compatibility. For more advanced popup features with additional triggers like exit intent, inactivity detection, click tracking, and advanced display conditions, consider using the new Popup Builder custom post type found in WordPress dashboard → Floating Blocks → Add New.