Configure the promo popup

The Promo popup displays promotional content, announcements, newsletter forms, or special offers in a modal window.

Enable the promo popup and add content#

1. Navigate to Dashboard -> Theme Settings -> General -> Promo popup.

2. Enable Enable promo popup.

3. Select a content type in Promo popup content:

• Text: enter simple content in the built-in editor. The field supports formatting, links, images, and shortcodes.
• HTML Block: select a reusable layout created with your active page builder. This option provides more flexibility for images, forms, and custom layouts. Create HTML blocks through Dashboard -> HTML Blocks or use the Create new HTML Block link in the settings.

4. Configure the appearance and display settings, then click Save options.

Configure the appearance#

• Popup background: sets the popup background color or image, including its size, repeat, and position.
• Popup text color: selects a dark or light color scheme for the popup content. Choose the scheme that contrasts with the background.
• Popup width: sets the popup width from 400 to 1000 pixels.
• Popup padding: sets the internal spacing in pixels or percentages. Use 0 if the selected HTML Block already includes the required spacing.
• Hide on mobile devices: prevents the promo popup from appearing on mobile screens.

Choose when the popup appears#

Use Show popup after to select the automatic display method:

• Some time: displays the popup after the delay entered in Popup delay. Enter the value in milliseconds; for example, 2000 equals 2 seconds.
• User scroll: displays the popup after the visitor scrolls the number of pixels specified in Show after user scroll down the page.

Show after number of pages visited adds a page-view threshold before the selected automatic trigger can display the popup. Set it to 0 to allow the popup on the first page. Higher values delay it until the visitor has viewed more pages.

Control repeated displays#

After an automatic trigger displays the promo popup, its state is stored in a cookie. The cookie expires after 7 days by default, so the popup can appear automatically again after that period.

Increase Popup version after making significant changes to the popup. A new version uses a new stored state and allows the updated popup to appear for visitors who have already seen the previous version.

To open the promo popup manually, add the CSS class woodmart-open-newsletter to a clickable element. Manual opening is not limited by the automatic trigger state.