Message popup

Deliver a focused promotion or announcement in a configurable popup.

The Message popup is a flexible overlay for a promotion, campaign message, or short call to action. Use it when the message needs more structure than an Announcement bar but does not need a form.

Guide status.

The current Message popup schema, block types, and limits are documented below. Final visual and mobile screenshots require accepted browser behavior.

Add or open this feature

In Shopify, open Online Store > Themes > Customize, select the Overlay group, and open Message popup. Strata allows one Message popup in the overlay group. It follows Search drawer in the current saved overlay order.

Behavior

Turns the popup on or off. The remaining behavior settings are shown when it is enabled.

Sets the delay before the popup can appear, from 0–30 s in 1 s steps.

Show only on home page

Limits the popup to the home page. Enable this for a home-page campaign; disable it for a store-wide notice.

Disable for account holders

Prevents the automatic popup from appearing to signed-in customers. Use it when account holders should not receive the same acquisition or promotion prompt.

Show once to visitors

Stores the shown state in the visitor's browser so the automatic popup appears once. Disable it for a recurring message, and remember that a different browser or cleared browser storage can produce a new visitor state.

Content

Header image

Adds an optional image above or beside the message. The image keeps its original ratio and is not cropped.

Accessibility label

Provides a label for the popup when no Heading block is present. Write a short description of the purpose of the message rather than a generic label.

Layout

Position

Choose Left, Bottom left, Right, or Bottom right. Use an edge position that does not cover the primary navigation, cart, or an important product control in the opening view.

Image position

Choose Top or Left. Top places media above the message; Left places it beside the content where the layout supports it.

Content alignment

Choose Left or Center for the popup content.

Blocks

You can add up to 20 blocks. Reorder blocks to control reading order. A useful sequence is an Eyebrow, Heading, Rich text, then Button, but you can omit blocks that do not answer a real visitor question.

Eyebrow

The Text field adds a short context line above the main heading, such as a campaign label.

Heading

The Heading field adds the main message. Size offers Large, Medium, or Small. Choose the size according to the importance of the message within the popup, not only the length of the text.

Rich text

The Text field adds formatted supporting copy. Keep essential terms and conditions readable without requiring a visitor to open another page.

Button

The Label is the action text and URL is its destination. Leave URL blank to hide the button. Style offers Primary or Secondary.

Merchant choice	Result
Enable popup off	The automatic message does not appear.
Show once to visitors on	The browser remembers that the message has been shown.
Header image with Image position Top	Image sits above the message.
Header image with Image position Left	Image sits beside the message when space permits.
No Heading block	Accessibility label supplies the popup label.
Button URL blank	The Button block does not show a button.

Desktop and mobile behavior

The position and image layout adapt to the viewport. Review the popup with a long heading and a long button label on mobile; the accepted fixture will document any final stacking or spacing differences.

Accessibility and motion

Use a heading or a descriptive Accessibility label, keep button labels action-oriented, and ensure the message remains understandable when motion is reduced. Verify focus order and close behavior before using the popup for critical information.

Common issues

The popup is not visible: check Enable popup, the delay, page restriction, and the browser's Show once to visitors state.
The button is missing: give the Button block a URL.
The image looks different from the source: the source ratio is preserved; try Image position or a less tightly cropped source image.
The popup appears for the wrong audience: check Show only on home page and Disable for account holders.

Version note

This guide follows the current Message popup schema and saved overlay order. Final interaction screenshots are pending accepted browser review.