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

# Newsletter popup

This section can be disabled so as not to conflict with third-party newsletter subscription apps.

{% hint style="info" %}
To modify the label for the form field, the button text or the success message, edit the theme translations by clicking the **...** button and selecting **Edit default theme content.**
{% endhint %}

{% hint style="info" %}
To add borders around the popup, adjust the [global overlay borders](/theme-settings/appearance.md#show-borders) setting in theme settings.
{% endhint %}

### Settings

* **Heading**: Choose a heading for the popup
* **Heading font:** Choose a heading style for the heading
* **Horizontal/vertical alignment:** This controls the positioning of the popup on the screen. The horizontal alignment may not be apparent on smaller screens.
* **Color scheme**: Choose a color scheme
* **Display conditions:**
  * **Show once per visitor:** This will ensure that the popup will only be displayed to the visitor once per device. Customers may be annoyed by having to dismiss this popup repeatedly, so we suggest enabling this setting.
  * **Only show on homepage:** This disables the newsletter popup on all other pages except for the homepage.
  * **Show for logged in users:** This will enable the popup for users who have an account but are not subscribed to the newsletter.
  * **Popup delay:** This allows you to set a specific timer for when the popup will be triggered. Displaying the popup too early may cause missed signups if the customer has not had sufficient time to interact with your content."

### Blocks

All [theme blocks](/blocks.md) are available to use in this section, plus the [newsletter](/blocks/section-blocks/newsletter.md) block for the newsletter form itself.

<details>

<summary>Where do my newsletter signups go?</summary>

When someone signs up through your newsletter form, it creates a new Customer in the Shopify Admin with the ‘Email Subscription’ status set to subscribed.

</details>


---

# 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://docs.ultramarinastudios.com/sections/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.