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

# Newsletter popup

### Configure the newsletter popup

Select the customize theme option. Click on the dropdown menu at the top to select the **Home page** template**.**

From the left side menu, select the **newsletter popup.**

Customize the section by utilizing the settings on the right side of the theme editor, as described below:

<table data-header-hidden><thead><tr><th width="281"></th><th></th></tr></thead><tbody><tr><td>Display mode</td><td>Choose the display mode from the following options:<br>- Enable<br>- Test mode<br><br><em>(Note: In test mode the popup always displays despite the relevant settings or dismissing so that you can review all the time. When satisfied with the look, switch to 'Enable'.)</em></td></tr><tr><td>Color scheme</td><td>Choose the color scheme for the popup.</td></tr><tr><td>Content position</td><td>Select positions from the following options:<br>- Top: Left/Center/Right<br>- Middle: Left/Center/Right<br>- Bottom: Left/Center/Right</td></tr><tr><td>Show on home page only</td><td>Select this checkbox to show popup on home page only.</td></tr><tr><td>Show once to visitors</td><td>Select this checkbox to show the popup to visitors only once. For them, the popup will reappear after 30 days, if users closed the popup.<br><br><em>(Note: If the settings <strong>Show once to visitors</strong> and <strong>Set cookie for newsletter popup(days),</strong> both are set, then the <strong>Show once to visitors</strong> will be given priority.)</em></td></tr><tr><td>Disable for account holders</td><td>Select this checkbox to hide popup for account holders only.</td></tr><tr><td>Delay until the popup appears (on page load)</td><td>Adjust the range bar to determine the delay time, until the popup appears on page load.</td></tr><tr><td>Set cookie for newsletter popup(Frequency)</td><td>Set the time (days) for which you want the cookies to expire. <br><br>For example, if you set the time as two days, and the storefront customer closes the newsletter popup or submits their email for subscription, after two days, the popup will reappear on the storefront.</td></tr></tbody></table>

### Block settings

<table><thead><tr><th width="291"></th><th></th></tr></thead><tbody><tr><td>Icon</td><td><strong>Choose from</strong><br>Choose icon type from icon list or custom icon.<br><br><strong>Icon list</strong><br>Choose from the list of icons.<br><br><strong>Custom icon</strong><br>Add any icon image from store library.<br><br><strong>Icon width</strong><br>Adjust the range bar to determine the maximum width of icon on the desktop.<br><br><strong>Mobile icon width</strong><br>Adjust the range bar to determine the maximum width of icon on the mobile.</td></tr><tr><td>Heading</td><td><p><em><strong>Heading</strong></em> </p><p><em>Add heading text.</em> <br><em>(<strong>Note</strong>: Enter ++ for a line break and wrap text in [ ] to apply the highlight settings.)</em><br><br><strong>Heading tag</strong><br>Specify heading code types from H1-H6, div, span or p tag for SEO and search engines for crawling purposes.<br><br><strong>Heading font size</strong><br>Select the font size from the following options:<br>- Heading XL<br>- Heading L
<br>- Heading M<br>- Heading S<br>- Heading XS
<br>- Heading XXS<br><br>Highlight text<br><strong>Highlight style</strong><br>Choose the style from following options:<br>- None<br>- Underline<br>- Text color<br>- Gradient<br><br><strong>Font</strong><br>Choose the text font family from the following options:</p><p>- Heading <br>- Body <br>- Accent <br>(<em><strong>Note</strong>: These fonts can be changed in theme settings>typography.)</em><br><br><strong>Highlight</strong> <strong>color</strong><br>Choose any solid or gradient color for the heading's highlight text.<em>)</em></p></td></tr><tr><td>Description</td><td><p><strong>Description</strong></p><p>Add description text.  <br><br><strong>Description font size</strong><br>Choose the font size from following options:<br>- Extra Large<br>- Large<br>- Medium<br>- Regular<br>- Small<br>- Extra small</p></td></tr><tr><td>Form</td><td><strong>Term &#x26; Policy text</strong><br>Enter the terms and policies text.<br><br><strong>Text font size</strong><br>Choose the font size from following options:<br>- Medium<br>- Regular<br>- Small<br>- Extra small</td></tr></tbody></table>


---

# 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://shinedezign.gitbook.io/metro/overview/newsletter-popup.md?ask=<question>&goal=<endgoal>
```

`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.