# Email sign-up

### Section overview

The newsletter section allows you to add an email signup form to your store, featuring customizable content, layout options, and visual elements.

#### Common use cases

* Collecting visitor email addresses for marketing campaigns
* Growing your subscriber list to drive repeat business
* Offering newsletter-exclusive promotions or content
* Building an engaged community around your brand

#### Usage tips

* Keep the signup form simple and clearly communicate the value proposition
* Use compelling copy that explains benefits of subscribing
* Consider offering an incentive for signing up (discount, free shipping)
* Ensure the section maintains readability on mobile devices by adjusting width settings
* Test the form submission process to verify proper functionality

### Section settings

| Setting           | Description                                                          |
| ----------------- | -------------------------------------------------------------------- |
| Top spacing       | Controls the amount of padding above the section (0-300px)           |
| Bottom spacing    | Controls the amount of padding below the section (0-300px)           |
| Color scheme      | Determines the background color scheme from predefined theme options |
| Color custom      | Sets a custom background color when color scheme is set to "custom"  |
| Color text        | Determines text color - default, forced light, or forced dark        |
| Color border      | Sets the border color - subtle or strong                             |
| Color button      | Sets the style and color of the subscribe button                     |
| Enable color fade | Enables smooth color transitions between sections when scrolling     |
| Border position   | Controls where borders appear - none, top, bottom, or both           |
| Y alignment       | Sets vertical alignment of blocks - top, middle, or bottom           |
| X alignment       | Sets horizontal alignment of blocks - left, center, or right         |
| Enable margin     | Toggles horizontal margin on the section                             |
| Visibility        | Controls section visibility on different device types                |

### Block settings

#### Newsletter

The newsletter block contains the email signup form with heading, content and form elements.

* Block limit: 1

| Setting         | Description                                              |
| --------------- | -------------------------------------------------------- |
| Heading         | The title displayed above the signup form                |
| Content         | Descriptive text explaining the newsletter benefits      |
| Button label    | Text displayed on the submit button                      |
| Disclaimer      | Optional fine print text displayed below the form        |
| Success message | Message shown after successful form submission           |
| Width desktop   | Controls block width on desktop devices (1-12/12)        |
| Width mobile    | Controls block width on mobile devices (1-12/12)         |
| X alignment     | Sets text and content alignment - left, center, or right |

#### Image

The image block allows adding a complementary visual element alongside the newsletter form.

* Block limit: 1

| Setting       | Description                                       |
| ------------- | ------------------------------------------------- |
| Image         | The image to display alongside the form           |
| Width desktop | Controls image width on desktop devices (1-12/12) |
| Width mobile  | Controls image width on mobile devices (1-12/12)  |


---

# 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://help.brickspacelab.com/space/sections/forms/email-sign-up.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.