# Newsletter

<figure><img src="/files/dO2U5Onb7YyNjWtrY8aF" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**Quick start**

* Choose a style:
  * If you want a **background image**, click into the section settings and update the image setting (optionally, choose a different color scheme to improve text contrast)
  * Else if you prefer a **solid color background**, simply keep as is or choose a different color scheme in section settings
* Edit the nested blocks ([heading](/blocks/heading.md), [text](/blocks/text.md), [newsletter](/blocks/section-blocks/newsletter.md))
  {% endhint %}

### Settings

* **Media**: Choose a **desktop image** and, optionally, a **mobile image**
* **Layout**: Note that the following settings only apply if you're using a background image:
  * **Desktop/mobile height**: Choose between **Adapt**, which uses the same aspect ratio as the uploaded image, or one of three fixed sizes, **Small, Medium** and **Large**, for both desktop and mobile.
  * **Stack content**: By default, text content is positioned over the image (the **never** option). When stacked, content will be positioned below the image instead of overlaid. Choose to stack on **mobile** only or **always** to stack on bock desktop and mobile.
  * **Media frame**: Can be used to add a border or frame effect to your image. The background color of this frame inherits from the current color scheme.
  * **Media content padding**: When the text content is overlaid, this setting allows you to choose its spacing from the edge of media. This setting may therefore only be noticeable when the content is aligned to the top/bottom or left/right. **Default** aligns the content to the page width where possible.
* **Text content**: See common settings [container width](/common-settings.md#container-width), [horizontal/vertical alignment](/common-settings.md#horizontal-and-vertical-alignment)
* **Colors**:&#x20;
  * **Enable overlay**: To improve readability of the text over all screen sizes, use the **enable overlay** setting. Applying a semi-transparent overlay is a great way to ensure both the image and text are visible.
  * **Overlay color**: Choose the linear gradient color

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

{% hint style="info" %}
Can't find the setting you're looking for?  The following settings are explained in detail in [common settings](/common-settings.md):

* Color scheme/Color scheme transition
* Section padding
  {% endhint %}

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