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

# Newsletter

The **Newsletter** block (Email Subscription) provides a dedicated form for capturing customer email addresses for marketing purposes. You can customize the input placeholder text, the button label, and define the block's width and spacing.

<figure><img src="https://1059363070-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRcDJSoM26kdEZlVFekVW%2Fuploads%2F7YKEmp6SiNtJmcnzwjrz%2Fimage.png?alt=media&amp;token=f4facd5c-9619-48a1-879a-c628ce2eec1a" alt=""><figcaption></figcaption></figure>

## General settings

| Setting                    | Description                                                                                                                                                                   |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Email placeholder text** | <p>Specifies the placeholder text displayed inside the email input field.</p><p>This text serves as a hint or example to guide users on the type of information to enter.</p> |
| **Button label**           | Defines the text displayed on the contact form’s submit button.                                                                                                               |

## Size

<table><thead><tr><th width="193.79998779296875">Setting</th><th width="120.199951171875">Applies To</th><th>Description</th></tr></thead><tbody><tr><td><strong>Width</strong></td><td>Desktop</td><td><p>Defines the width of the form block on larger screens:</p><ul><li>Fit (Default — size determined by content)</li><li>Fill (Expands to fill available space)</li><li>Custom (Allows setting a specific percentage width).</li></ul></td></tr><tr><td><strong>Custom Width</strong></td><td>Desktop</td><td><p><em>Only visible when Width is Custom</em>.</p><p>Use the slider to set a specific block width, measured in percentage (%) (Range: 0% to 100%).</p></td></tr><tr><td><strong>Mobile Width</strong></td><td>Mobile</td><td><p>Defines the width of the form block on smaller screens:</p><ul><li>Fit</li><li>Fill (Default)</li><li>Custom.</li></ul></td></tr><tr><td><strong>Custom Mobile Width</strong></td><td>Mobile</td><td><p><em>Only visible when Mobile Width is Custom</em>.</p><p>Use the slider to set a specific block width on mobile, measured in percentage (%) (Range: 0% to 100%).</p></td></tr></tbody></table>

### Spacing

These settings control the external spacing (padding) applied directly above and below this specific block.

| Setting    | Description                                                                                                      |
| ---------- | ---------------------------------------------------------------------------------------------------------------- |
| **Top**    | Sets the amount of empty space (padding) above this button block. Measured in pixels (px) (Range: 0px to 100px). |
| **Bottom** | Sets the amount of empty space (padding) below this button block. Measured in pixels (px) (Range: 0px to 100px). |