Popups

#Overview

Popups let you display announcements, promotions, sign-up prompts, or age verification messages to visitors. You can control when they appear, how often they appear, and exactly where they should be shown.

#Creating a Popup

1. Navigate to Template > Popups.
2. Click Create Popup.
3. Enter a Name.
4. Choose a Type:
   • Image for image-based popups
   • Content for text/editor popups
   • Age for age verification
5. Configure the popup content and display settings.
6. Click Save.

#Adding Alt Text to an Image Popup

When you choose the Image type, an Alt Text field appears beneath the image. Alt text is a short description of the image that screen readers announce to visitors who can't see it, and that search engines use to understand the image. Adding it improves both accessibility and SEO.

1. Choose the Image type and select or upload your image.
2. In the Alt Text field, write a concise description of what the image shows (for example, "Hand-engraved whiskey bottle on a wooden table"). Keep it under 255 characters.
3. Save the popup.

#Generating Alt Text with AI

If the OpenAI plugin is installed and active, a sparkle button appears next to the Alt Text field so you can generate a description automatically:

1. Select or upload the popup image first.
2. Click the sparkle button next to Alt Text.
3. CMS Max sends the image to OpenAI and fills the field with a suggested description.
4. Review and edit the wording if needed, then save.

Note: The sparkle button only appears when the OpenAI plugin is active. If you select the button before choosing an image, CMS Max prompts you to add an image first.

#Controlling Where a Popup Appears

Use Pages to show on in the Display options panel:

• Home Page — Shows only on your homepage (/)
• Every Page — Shows across your site
• Specific Pages — Shows only on pages you select
• All Pages Except — Shows across your site except on pages you select

If you choose Specific Pages, a second field appears:

1. Click Specific pages to show on.
2. Search by URL path.
3. Select one or more targets.
4. Save the popup.

If you choose All Pages Except, a second field appears:

1. Click Pages to exclude.
2. Search by URL path.
3. Select one or more targets.
4. Save the popup.

Important: If a selected page URL is later removed from your site, CMS Max automatically removes that deleted URL from the popup's selected targets.

If the deleted URL was the final selection for All Pages Except, CMS Max changes the popup to Every Page so its site-wide behavior is explicit in the popup list and editor. If it was the final selection for Specific Pages, the popup no longer appears anywhere until you select another page.

#Display Timing and Frequency

You can also control:

• Starts on and Ends on to schedule popup visibility
• Frequency (for example, every time vs once)
• Enabled/Disabled status

This makes it easy to run temporary campaigns without manually toggling popups on and off.

Only one popup is shown on a page at a time. When multiple enabled popups match the same page and schedule, the popup with the earliest Starts on date is shown first. If their start dates are identical, the one created first is shown first. Once-only popups leave the order after they have been shown during the visitor's current session, allowing the next matching popup to appear.

CMS Max allows overlapping popup schedules. It shows a warning when you save an enabled popup whose schedule overlaps another enabled popup, but it does not block the save.

#Frequently Asked Questions

#Why is my popup not appearing on a page I selected?

Confirm that:

1. The popup is Enabled.
2. The current date is between Starts on and Ends on (or those fields are blank).
3. The page is included in Specific pages to show on, or is not listed in Pages to exclude.
4. Frequency settings are not preventing repeat display.

#What happens if I delete a page selected in popup targeting?

For Specific Pages, CMS Max removes the deleted URL. If no selected URLs remain, the popup no longer appears until you select another URL. For All Pages Except, deleting the final excluded URL changes the popup to Every Page.