Skip to content
Faubourg

Search the documentation

Type a setting, a section or a question.

Sections

Pop-up

A window or corner panel that opens over the page once a visit: your newsletter sign-up, a promotion or a discount code.

On this page

The pop-up opens over the page once a visit, on the cue you choose: to invite shoppers to sign up for your emails, to announce a promotion, or to give a discount code. It lives in the Overlays group, under the footer in the theme editor's sidebar, and ships turned off.

Name in the editor
Pop-up (FR: Fenêtre contextuelle)
Where to add it
Overlays group only (shipped turned off)
Accepted blocks
TextRich textButtonNewsletterDiscount code

Turn it on

Find the section

In the theme editor's sidebar, below the footer, open the Overlays group: it holds the Pop-up section, hidden.

Show it

Click the eye icon next to the section to show it on your store.

Edit it

Select the section or one of its blocks: the pop-up opens in the preview so you can see your changes. In the editor it never opens on its own.

Settings

SettingValuesWhat it does
HeadingFR: TitreTextDefault: “Subscribe to our emails”—
ImageImage—
DisplayFR: Affichage
  • Centered window
  • Corner panel, bottom left
  • Corner panel, bottom right
Default: Centered window
A window holds the page until the shopper answers or closes it. A corner panel leaves the page usable. On a phone both rise from the bottom edge.
Image positionFR: Position de l’image
  • Left
  • Right
  • Above
Default: Left
On a phone the image always sits above.Shown when “Display” is “Centered window”.
OpensFR: Ouverture
  • After a delay
  • After scrolling
  • When leaving the page
Default: After a delay
On phones and tablets, which have no pointer to leave with, “When leaving the page” opens it after the delay.
Page scrolledFR: Part de la page parcourueFrom 10 to 90%, in steps of 10Default: 30%—Shown when “Opens” is “After scrolling”.
Opens afterFR: S’ouvre aprèsFrom 0 to 30sDefault: 5sCounted from when the page has loaded. It opens once a visit at most, and not at all after the shopper has subscribed.Shown when “Opens” is not “After scrolling”.
Show again afterFR: Réafficher aprèsFrom 1 to 90dDefault: 30dCounted from the day the shopper closed the pop-up. A shopper who subscribes is not asked again.
Show a tab after closingFR: Afficher un onglet après fermetureCheckboxDefault: OffA tab with the heading, at the edge of the page, opens the pop-up again. It is gone once the shopper subscribes.
Shown onFR: Affichée sur
  • Every page
  • Home page only
Default: Every page
—
Color schemeFR: Palette de couleursColor schemeDefault: Scheme 1—

How it looks

  • Display: a Centered window holds the page behind a veil until the shopper answers or closes it. A Corner panel (bottom left or bottom right) sits in the corner and leaves the page usable: the shopper can keep scrolling and clicking, and the panel doesn't take the keyboard focus as it opens. On phones, both rise from the bottom edge as a full-width sheet, up to most of the screen's height, scrolling inside when the content is longer.
  • Image and Image position: in a centered window, the image sits to the Left or Right of the text (the window widens for it), or Above it. A corner panel is too narrow for an image beside the text, so its image always sits above. On phones, the image is always a band above the text.
  • Heading ("Subscribe to our emails" by default) shows above the blocks and names the pop-up for screen readers. Left empty, no heading shows and your store's name names it.
  • A No thanks link under the blocks closes the pop-up.

When and where it opens

  • Opens:
    • After a delay: Opens after (0 to 30 seconds, 5 by default) is counted from when the page has finished loading.
    • After scrolling: once the shopper has scrolled the share of the page set in Page scrolled (10 to 90%, 30% by default). A page too short to scroll never opens it.
    • When leaving the page: as the mouse pointer leaves the window through its top edge, towards the tabs or the address bar. Phones and tablets have no pointer to leave with, so there it opens after the Opens after delay.
  • Shown on: Every page, or Home page only.
  • Whatever you choose, it stays off the pages where a shopper is in the middle of something: the cart, the customer account pages (sign-in, account, orders…), search results, Shopify's bot check, the password page and the gift card page.
  • Once a visit: once it has opened, it doesn't open again on its own on the shopper's next pages until their next visit.
  • After the cookie banner: where Shopify's cookie consent banner is showing, the pop-up waits until the shopper has answered it, by accepting or refusing, before its delay or cue starts.
  • Never over what the shopper is doing: if a drawer is open (cart, menu, filters…) or the shopper is typing in a field when the time comes, the pop-up waits the same delay again, or for the next scroll or the next exit.

When the shopper closes it

  • Show again after (1 to 90 days, 30 by default): closing the pop-up, by its close button, No thanks, the Escape key or a click outside a centered window, keeps it away in that browser for this many days, counted from the day it was closed.
  • Show a tab after closing (off by default): once the shopper has closed the pop-up, a tab carrying its heading (or your store's name) stands upright at the page's edge, halfway down, on that page and the following ones. It sits on the right edge, or on the left for a corner panel at the bottom left. Clicking it opens the pop-up again. The tab is hidden while the pop-up is open, and gone once the shopper has subscribed, when the pop-up holds a sign-up. In the editor, the tab shows while the setting is on, so you can see it.

Blocks

The section accepts the Text, Rich text and Button blocks, a Newsletter block and a Discount code block. The shipped pop-up contains one Newsletter block.

Newsletter

The same sign-up form as the Newsletter section. Addresses are saved to your Shopify customers; see Where to find your subscribers.

SettingValuesWhat it does
Confirmation messageFR: Message de confirmationRich textShown once a shopper subscribes through this form. Anyone can open the page Shopify returns to, so a code written here is not a secret: limit its use on the discount in the Shopify admin. Leave it empty for the theme’s thanks.
Customer tagFR: Balise clientTextAdded to the customer beside “newsletter”, so an email automation can greet those who subscribed here.
  • Confirmation message replaces the theme's "Thanks for subscribing." for sign-ups made through this form. Left empty, the theme's thanks shows.
  • Customer tag is added to the customer beside newsletter, for example popup, so an email automation, in Shopify Email or Shopify Flow, can greet those who subscribed here.
  • The answer stays in the pop-up: after a sign-up, the page reloads and the pop-up opens again on the answer. When the sign-up is taken, the heading, the other blocks, the field and No thanks step aside: only the confirmation and any discount code remain. When it fails, the error shows under the field.
  • The Newsletter block accepts one kind of block of its own, a Discount code, shown only once the sign-up is taken (see below).

Discount code

Shows a code in large type, which one click selects whole, with a Copy code button and, optionally, an Apply to cart link. Create the discount itself, with the same code, in Discounts in your Shopify admin: the block only shows the code. Left empty, the block shows nothing.

SettingValuesWhat it does
CodeTextShowing a code controls where it appears, not who can use it. Limits such as once per customer or eligibility are set on the discount in the Shopify admin. Inside the newsletter block, it shows once the sign-up is taken.
Show a link that applies it to the cartFR: Afficher un lien qui l’applique au panierCheckboxDefault: Off—
  • Where you place it decides when it shows. Added to the pop-up itself, it shows from the start, whenever the pop-up opens: a promotion for everyone. Added inside the Newsletter block, it shows only on the page Shopify returns to once it has taken the sign-up, under the confirmation. In the editor it always shows, so you can edit it.
  • Copy code copies the code and says "Code copied" for a moment. Where the browser refuses the copy, the code is selected instead and the button says "Code selected, ready to copy", so the shopper can copy it themselves. Where the browser can't copy at all, or without JavaScript, there is no button: the code is text to select.
  • Show a link that applies it to the cart adds an Apply to cart link: it applies the code through Shopify's discount link and opens the cart.

Subscribers aren't asked again

A pop-up holding a Newsletter block stays away from shoppers who have already subscribed:

  • A sign-up from any newsletter form on your store, the pop-up's, the footer's or the Newsletter section's, is remembered in that browser: from then on the pop-up doesn't open there, and its tab is gone.
  • A logged-in customer who already accepts email marketing isn't asked either, in any browser.

A pop-up without a Newsletter block (a promotion, or a code for everyone) keeps opening for subscribers, by its other rules.

Everything the pop-up remembers (a sign-up, a close, an opening this visit) is kept in the shopper's browser: another browser, or cleared browsing data, starts afresh. Without JavaScript, the pop-up and its tab never show.

Was this page helpful?

Faubourg 1.1.0