> For the complete documentation index, see [llms.txt](https://uxsmart.gitbook.io/velare/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://uxsmart.gitbook.io/velare/customize-your-pages/overlay-group/newsletter-popup.md).
# Newsletter popup
The **Newsletter popup** is an email signup window that opens on top of your store and asks visitors to subscribe to your mailing list. It pairs a banner image with a short pitch and an email field, and it can also show a collection selector so a visitor who is not ready to subscribe still has somewhere to go. Use it to turn first-time visitors into contacts you can market to later, which matters most for stores where shoppers rarely buy on the first visit.
This is the general purpose signup popup. It is not the exit-intent one ([Before you leave](/velare/customize-your-pages/overlay-group/before-you-leave.md)), not the campaign banner one ([Discount popup](/velare/customize-your-pages/overlay-group/discount-popup.md)), and not the icon-triggered one ([Offers popup](/velare/customize-your-pages/overlay-group/offers-popup.md)).
### Where to find it
{% hint style="success" %}
**Steps:**
1. Go to **Online Store > Themes > Customize**.
2. In the left sidebar, open the **Overlay** group.
3. Click **Newsletter popup**.
4. Upload the banner image and write the heading, description, and button label.
{% endhint %}
*Result:* the popup preview opens in the editor with your content, and subscribers who sign up are added to your Shopify customer list.
### General settings
| Setting | Description |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Show only on homepage** | Limits the interruption to the homepage, so visitors who land straight on a product page from an ad or a search result are left to shop. |
| **Width** | How much of the screen the window covers. **Full width** stretches it across the screen and is hard to ignore, **Auto** sizes it to its content so it reads as a compact card. |
| **Banner image** | The picture beside the signup form, which is what makes the window look like part of your brand instead of a system message ***(350px x 410px recommended)***. |
| **Image width** | How much of the window the picture takes, leaving the rest for your pitch. Reduce it when the wording needs more room than the photo does. |
| **Desktop image position** | Which side of the window the picture sits on for desktop visitors, *left* or *right*. |
#### Collection selector settings
| Setting | Description |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Enable collections selector** | Adds a shortcut to your featured collections under the form, so a visitor who does not want to subscribe still leaves with somewhere to go instead of just closing the window. |
### Newsletter settings
| Setting | Description |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Heading** | The first line a visitor reads in the window. Say what they get in return, such as early access or a discount, rather than simply asking them to subscribe. |
| **Description** | The line under it that fills in the offer, for example what you send and how often you send it. |
| **Email placeholder** | The greyed-out text inside the email box before the visitor types, for example *Enter your email*. |
| **Button label** | The wording on the button that submits the form. Something specific such as *Get my discount* reads better than *Submit*. |
| **Policy text** | The small print under the form, where you say what you will do with the address and link to your privacy policy. |
### What changes on the storefront
* The popup covers the page until the visitor subscribes or closes it, so keep the copy short.
* With **Show only on homepage** enabled, visitors who land directly on a product page from an ad or a search result are not interrupted.
* If **Enable collections selector** is on, the popup doubles as a navigation shortcut for visitors who do not want to subscribe.
### Related pages
* [Overlay group](/velare/customize-your-pages/overlay-group.md): the other panels and popups
* [Discount popup](/velare/customize-your-pages/overlay-group/discount-popup.md), [Before you leave](/velare/customize-your-pages/overlay-group/before-you-leave.md), [Offers popup](/velare/customize-your-pages/overlay-group/offers-popup.md): the other three popups, so you can avoid showing two at once
* [Footer](/velare/set-up-your-store/footer-group/footer.md): the newsletter block in the footer, for visitors who ignore the popup
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://uxsmart.gitbook.io/velare/customize-your-pages/overlay-group/newsletter-popup.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.