Set up the newsletter popup

Get 20% off

Newsletter popup settings

The Email signup popup includes the following main settings.

Delay before showing

Controls how many seconds Maison waits before automatically opening the popup.

Available range:

0–30 seconds

Frequency

Controls how many days Maison waits after the popup has been dismissed before it can automatically appear again.

Available range:

0–30 days

Setting the value to 0 allows the popup to show on every visit.

Show on home page only

Limits the popup to the storefront home page.

Show only to visitors

Hides the popup from logged-in customers.

Image

Adds a visual image to the popup on desktop.

The image is intentionally hidden on mobile in this version of Maison.

Floating bar

Adds a clickable side teaser that can manually open the newsletter popup.

Floating bar settings

The floating bar includes:

Show on

Available options:

Disabled
Mobile
Desktop
Desktop & mobile

Text

Controls the teaser message.

The default Maison example uses:

Get 20% off

Position

Available positions:

Left
Right

Newsletter popup behavior

• The Email signup popup belongs to the Overlay group.
• The popup can automatically open after a delay of 0–30 seconds.
• Maison stores the time when the popup is closed in browser local storage.
• The frequency setting determines when the automatic popup can appear again after dismissal.
• Setting the frequency to 0 allows it to appear on every visit.
• The popup can be limited to the home page.
• The popup can be hidden from logged-in customers.
• The popup image displays on desktop and is hidden on mobile.
• The floating teaser can be shown on mobile, desktop, both, or disabled.
• Clicking the floating teaser opens the popup manually.
• The popup can be closed with the close button.
• Maison also supports closing the modal through the background mask and Escape key where supported.
• If another theme modal is already open when the automatic timer finishes, Maison does not automatically open the Email signup popup at that moment.

Popup frequency behavior

Maison records the popup dismissal in the visitor's browser.

For example, with:

Frequency: 7 days

after the visitor closes the popup, Maison waits until at least seven days have passed before the automatic popup becomes eligible to display again.

This behavior is browser-specific.

The popup may appear again sooner if:

• The visitor uses another browser.
• The visitor uses another device.
• Browser local storage is cleared.
• Private browsing or browser restrictions prevent the stored value from being retained.

Desktop and mobile behavior

On desktop:

• The modal uses a centered popup layout.
• The optional popup image is displayed.
• The content appears inside the Group block.
• The floating teaser can appear on the left or right side.

On mobile:

• The popup image is hidden.
• The signup content remains available.
• The floating teaser can be enabled separately for mobile.
• The modal adapts to the available screen size.

Always preview the popup on both desktop and mobile after making layout changes.

Recommended setup

A typical Maison newsletter popup can use:

Delay before showing: 5 seconds
Frequency: 7 days
Show on home page only: Optional
Show only to visitors: On

Image:
Newsletter promotional image

Group:
Heading
Email signup
Text
Social media

Floating bar:
Show on: Desktop & mobile
Text: Get 20% off
Position: Left

Adjust the timing and frequency based on how often you want visitors to encounter the signup invitation.

Troubleshooting

If the newsletter popup does not appear, make sure the Email signup section is enabled in the Overlay group.

If the popup does not appear immediately while testing, check the Delay before showing setting.

If the popup appeared previously but no longer opens automatically, the browser may have stored the previous dismissal. Wait for the configured frequency period or test in a separate browser profile.

If Frequency is set to 0 but the popup still does not open, make sure the Email signup section is enabled and that the page meets the Home page only and Visitor only conditions.

If the popup appears on the home page but not other pages, disable Show on home page only.

If the popup does not appear while you are logged in, check whether Show only to visitors is enabled.

If the popup image does not appear on mobile, this is expected. Maison intentionally hides the Email signup modal image on mobile.

If the email form is missing, open the Group block and add an Email signup block.

If the popup has no heading or supporting text, add Heading and Text blocks inside the Group.

If the floating teaser does not appear, check Floating bar > Show on and make sure the selected device type matches the device you are testing.

If the teaser appears on the wrong side, change Floating bar > Position to Left or Right.

If the popup does not automatically open while another popup or modal is already open, close the other modal and reload the page for another test.

If you need the popup to open only when customers click the floating teaser and never automatically, the current Maison settings do not provide a complete teaser-only mode and a customization would be required.

Need Further Assistance

If you encounter any issues or need additional help with your Maison theme, please reach out to our support team via our Ticket System for assistance within 8 hours.