# 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: 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:

```
GET https://docs.ultramarinastudios.com/sections/newsletter-popup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.