> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/theme-blocks/forms/email-signup.md).

# Email signup

A newsletter signup form that adds subscribers to your Shopify customer list, with optional subscription-preference checkboxes.

***

## Form layout

**Form layout** decides how the field and the button are arranged. The last two layouts put the button inside the field, which changes what you can style further down the panel.

{% tabs %}
{% tab title="Horizontal" %}
The field and the button sit side by side, separated by the **Gap** setting. Turn on **Vertical on mobile** to stack them on small screens.
{% endtab %}

{% tab title="Vertical" %}
The button stacks below the field on every screen size, separated by the **Gap** setting.
{% endtab %}

{% tab title="Embedded button" %}
The button sits inside the field, so the two share one bordered box that highlights while the shopper is typing. **Gap** does not apply here.
{% endtab %}

{% tab title="Underline style" %}
The box is dropped entirely — the field and button sit on a single rule that darkens while the shopper is typing. The button always uses the Text style, and the row keeps the theme's default field height, so the button's **Style**, **Field height**, and **Gap** are all unavailable.
{% endtab %}
{% endtabs %}

***

## Settings

| Setting                         | Description                                                                                                                                                                                                             |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Form layout                     | How the field and button are arranged — see [Form layout](#form-layout) above.                                                                                                                                          |
| Vertical on mobile              | Stack the field and button on mobile even when the layout is horizontal. Horizontal layout only.                                                                                                                        |
| Enable subscription preferences | Show a set of checkboxes so subscribers can pick their interests. Selections are saved to the Notes section of the customer profile.                                                                                    |
| Title                           | Heading shown above the preference checkboxes.                                                                                                                                                                          |
| Option 1–5                      | Preference choices. Leave an option blank to hide it.                                                                                                                                                                   |
| Gap                             | Space between the field and button — set separately for desktop and mobile. Horizontal and Vertical layouts only.                                                                                                       |
| Device                          | Switches the Size settings below between **Desktop** and **Mobile** values.                                                                                                                                             |
| Width                           | **Fit** (content width), **Fill** (container width), or **Custom** percentage, with an optional **Limit width** / **Max width** cap.                                                                                    |
| Field height                    | Height of the input and button. Not available in the Underline style layout.                                                                                                                                            |
| Button                          | **Label**, **Style**, and icon settings (Show icon, Icon, Icon position, Icon size, with **Custom icon size** when set to Custom). **Style** is hidden in the Underline style layout, which always uses the Text style. |
| Animation                       | Entrance effect (Fade, Scale, Slide from left / right / bottom) played on scroll, with an optional **Delay**. Shown when block animations are enabled in theme settings.                                                |
| Padding                         | Outer spacing: top / bottom, with independent mobile values via **Custom for mobile**.                                                                                                                                  |