Promotional modal

A popup for a campaign: an image, a message, an email signup with an optional discount code, and buttons. It renders in the theme editor even while off, so you can finish it before turning it on.

Where to find it

In the theme editor, Add section › Promotional modal. Only in the header area.

Settings

Setting	Choices	Shows when	What it does
Show promotional modal	On · Off	Always	Keep this off until the campaign copy and destination are ready.
Campaign ID		Show promotional modal is on	Change this value to show a new campaign to visitors who dismissed the previous one.
Show on	All pages · Home page only	Show promotional modal is on
Delay		Show promotional modal is on	Seconds to wait after the page loads.
Repeat cadence	Every page view · Once per browsing session · Once per day · Once per week · Once per browser	Show promotional modal is on

Layout

Setting	Choices	Shows when	What it does
Color scheme		Always
Image		Always	Shown beside the text; on phones, above it. Without an image the popup is one column.
Image position	Left · Right	Always
Content alignment	Left · Center · Right	Always

Content

Setting	Choices	Shows when	What it does
Overline		Always
Heading		Always
Text		Always

Email signup

Setting	Choices	Shows when	What it does
Ask for an email	On · Off	Always	Signups join Customers with email marketing consent. Learn more
Subscribe button label		Ask for an email is on
Small print		Ask for an email is on
After signup: heading		Ask for an email is on
After signup: text		Ask for an email is on
After signup: discount code		Ask for an email is on	Optional. Create the code in Discounts first; it shows only after a successful signup, with a copy button.

Buttons

Setting	Shows when	What it does
Button label	Always
Button link	Button label is filled in	A button without a link shows only in the theme editor.
Second button label	Always
Second button link	Second button label is filled in	Leave empty and the button closes the popup, for a “Not now”.

Which settings reveal which:

flowchart LR
  enabled["Show promotional modal"]
  campaign_id["Campaign ID"]
  page_scope["Show on"]
  delay["Delay"]
  frequency["Repeat cadence"]
  show_email["Ask for an email"]
  email_button_label["Subscribe button label"]
  fineprint["Small print"]
  success_heading["After signup: heading"]
  success_text["After signup: text"]
  discount_code["After signup: discount code"]
  button_label["Button label"]
  button_link["Button link"]
  button_2_label["Second button label"]
  button_2_link["Second button link"]
  enabled -- "on" --> campaign_id
  enabled -- "on" --> page_scope
  enabled -- "on" --> delay
  enabled -- "on" --> frequency
  show_email -- "on" --> email_button_label
  show_email -- "on" --> fineprint
  show_email -- "on" --> success_heading
  show_email -- "on" --> success_text
  show_email -- "on" --> discount_code
  button_label -- "filled in" --> button_link
  button_2_label -- "filled in" --> button_2_link

Blocks

It also takes these blocks: Text, Image, Buttons.

Before you start

Email signups are saved as customers with email marketing consent, tagged newsletter, popup and popup- plus the campaign ID. Signed-in customers who already subscribe do not see the field. See Customers.
To give a code after signup, create it first in Discounts. See Discounts.