> For the complete documentation index, see [llms.txt](https://vshop.gitbook.io/vshop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vshop.gitbook.io/vshop/theme-settings/newsletter-popup.md).

# Newsletter popup

The Newsletter Popup settings allow you to create and manage a subscription popup that encourages visitors to join your mailing list. You can control when and where the popup appears and customize its

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FE4e2wyehnh4mHFqZVfdI%2Fnewlettets.png?alt=media&amp;token=7a912b39-39f8-4262-a4a1-3401b2824bbb" alt=""><figcaption></figcaption></figure>

To customize the Newsletter popup in our theme please follow the steps:

{% hint style="success" %}
Steps

1. In the theme editor (**Customize**), click **Theme settings**
2. Locate **Newsletter popup**
3. Make necessary changes
4. **Save**
   {% endhint %}

<figure><img src="https://370739323-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUoKuJAeox3jObJjxBdwE%2Fuploads%2FHLTfG2AvWA3GcdXxZFDZ%2Fnewletrer.png?alt=media&amp;token=41942cb0-b7b9-4d18-92dd-ab7e4298e786" alt=""><figcaption></figcaption></figure>

#### **General Settings**

* **Enable popup newsletter:** Toggle this option to activate the newsletter subscription popup on your store.
* **Show popup newsletter only on Home Page:** Enable this to display the popup exclusively on the homepage instead of every page.
* **Delay in sec:** Set the delay time (in seconds) before the popup appears after a visitor enters the site.
* **Days expired (cookie):** Determine how long (in days) before the popup is shown again to the same visitor. Setting it to `0` is useful for testing.

***

#### **Image Settings**

* **Image:** Upload or select an image to display inside the popup. This can be used for branding or promotional visuals.
* **Show image on mobile:** Enable this to display the popup image on mobile devices. Disable it for a cleaner mobile experience.
* **Image ratio:** Choose the aspect ratio for the popup image (e.g., *Original aspect ratio* or *Custom ratio*).
* **Custom ratio:** Enter a custom image ratio (for example, *21:9*) to control the image display dimensions.