# Popup ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(1\)_MuOv9G5w.jpg) Show a popup that greets visitors with an offer, so you grow your email list and turn first-time visitors into buyers. For example, show "Unlock 10% OFF your order" with an image and a newsletter sign-up form. ## How to customize the Popup 1. Open the theme editor by clicking **Edit theme**. 2. Scroll down to the **Overlay group** in the sidebar. 3. Click **Popup**. 4. Turn on **Enable**. 5. Select when the popup opens in **Trigger open automatically**. 6. Click the **Popup image** block and click **Select** next to **Image** to add the image. 7. Edit the **Text** and **Newsletter** blocks. 8. Click **Save**. ![image](https://docs-assets.foxecom.app/pebble-theme/image_zKCsHwIU.png) ## Section settings ### General | Setting | Description | Options | | ----------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Enable** | Turns the popup on or off. | **On** or **Off**. | | **Show on home page only** | Shows the popup only on your home page. | **On:** Shows the popup on the home page only.

**Off:** Shows the popup on every page. | | **Show for visitors only** | Hides the popup from customers who are logged in. | **On** or **Off**. | | **Trigger open automatically** | Sets when the popup opens. | **Open immediately after page loaded**

**Delay 5 seconds after page loaded**

**Customers scrolling down:** Opens after customers scroll down the page. On mobile, the popup opens after the page loads instead. | | **Time before popup appears again** | Sets how long to wait before showing the popup to the same visitor again. | **No repeat, Every 30 minutes, Every 1 hour, Every 6 hours, Every 12 hours, Every day, Every 3 days, Every week, Every 2 weeks,** or **Every month**. |
Turn on **Show for visitors only** when the popup offers a sign-up discount, so returning customers who are logged in don't see it. ### Appearance | Setting | Description | Options | | ------------------------ | -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | | **Inherit color scheme** | Controls whether the popup uses the theme's default color scheme. | **On** or **Off**. | | **Color scheme** | Sets the color scheme of the popup. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme.

*Available when **Inherit color scheme** is turned off.* |
## Blocks By default, the popup includes a **Popup image** block, an **Image** block for your logo, three **Text** blocks, a **Newsletter** block, and **Spacer** blocks between them. ### Popup image ![image](https://docs-assets.foxecom.app/pebble-theme/image_kD9H9V0a.png) The **Popup image** block shows the large image beside the popup content. | Setting | Description | Options | | ---------------- | --------------------------------- | ------------------------------------------------------------ | | **Image** | Sets the popup image on desktop. | Select or upload an image, or click **Explore free images**. | | **Image mobile** | Sets a separate image for mobile. | Select or upload an image, or click **Explore free images**. |
The **Popup image** block appears in the editor only when certain conditions are met. ### Spacer The **Spacer** block adds empty space between blocks. | Setting | Description | Options | | ----------------- | -------------------------- | ----------- | | **Height** | Sets the space on desktop. | **1–50px**. | | **Height mobile** | Sets the space on mobile. | **1–50px**. |
### Other blocks The default **Image**, **Text**, and **Newsletter** blocks show your logo, the offer, the sign-up form, and a short decline message, such as "I'll pay full price". To add more content, click **Add block** under the section and select one of these blocks: * **Basic:** * [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button. * [**Divider**](https://docs.foxecom.com/pebble-theme/theme-blocks/divider): Displays a line between blocks. * [**Heading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a title. * [**Icon**](https://docs.foxecom.com/pebble-theme/theme-blocks/icon): Displays an icon. * [**Image**](https://docs.foxecom.com/pebble-theme/theme-blocks/image): Displays an image, such as your logo. * [**Subheading**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a short line above or below the heading. * [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays the offer or other details. * [**Video**](https://docs.foxecom.com/pebble-theme/theme-blocks/video): Displays a video. * **Forms:** * [**Newsletter**](https://docs.foxecom.com/pebble-theme/theme-blocks/newsletter): Displays an email sign-up form. * **Layout:** * [**Grid**](https://docs.foxecom.com/pebble-theme/theme-blocks/grid): Arranges blocks in columns. * [**Group**](https://docs.foxecom.com/pebble-theme/theme-blocks/group): Keeps related blocks together. * **Spacer:** Adds empty space between blocks. * **Storytelling:** * [**Section header**](https://docs.foxecom.com/pebble-theme/theme-blocks/section-header): Displays a heading with supporting text. ## Tips and best practices * Use **Delay 5 seconds after page loaded** or **Customers scrolling down** so visitors see your store before the popup opens. * Set **Time before popup appears again** to at least **Every day** so the popup doesn't annoy returning visitors.