> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.ecomx.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Blum Newsletter

**Theme:** Blum · **Section type:** All-template section

The **Newsletter** section shows a heading, a short text, and an email sign-up form. Use it to grow your email list and tell customers what they get when they subscribe, such as a discount or early access.

> **Note:** You can add this section to any template, but not to the header or footer. To show a sign-up form in a popup instead, use the Newsletter popup. See Blum Popup.
![Newsletter section with a full-width background image](https://storage.crisp.chat/users/helpdesk/website/-/f/8/b/b/f8bb8da391016800/newsletter-1_qmpzhb.png)

**What you can do**
- Add the section and your text
- Add a background image
- Add a badge to the section
- See what customers see
- Look up every setting
- Fix common problems

---

## Add the section and your text

1. In the theme editor, open the template where you want the section.
2. In the left sidebar, click **Add section** > **Newsletter**.
3. Under **General**, enter a **Section subheading**, a **Section heading**, and a **Section description**. Leave a field empty to hide it.
4. Under **Layout**, select a **Content alignment**: **Left** or **Center**.
5. Click **Save**.

> **Tip:** Say what customers get in the heading, for example "Get 10% off your first order". A clear benefit gets more sign-ups than "Subscribe to our newsletter".

## Add a background image

1. Click the **Newsletter** section.
2. Under **Image**, select a **Background image**.
3. Under **General**, set the **Mask overlay opacity** and the **Mask overlay** color to darken the image, so the text stays easy to read.
4. Set the **Text overlay** color for the text on top of the image.
5. Optional: check **Enable full-width banner** to stretch the image across the full screen width.
6. Optional: under **Image**, check **Enable parallax effect** and select a **Parallax direction**: **Vertical**, **Horizontal**, or **Zoom**.
7. Click **Save**.

> **Note:** **Mask overlay opacity**, **Mask overlay**, and **Text overlay** apply only when the section has a background image.

> **Tip:** Choose a calm image without busy details behind the text. Check the mobile preview, because the image is cropped to fit the screen.

## Add a badge to the section

1. Click the **Newsletter** section.
2. Under **Prominent badge**, enter the badge **Text**, for example "New".
3. Select an **Accent scheme**, a **Position**, and a **Shape**.
4. Click **Save**.

To hide the badge, clear the **Text** field.

## What customers see

- **Sign-up form:** customers enter their email address and click **Subscribe**. The form checks that the email address is valid.
- **After subscribing:** a success message appears below the form. The email address is added to your customer list in the Shopify admin with the tag "newsletter".
- **Background image:** the image fills the section, with the mask overlay and text colors you set. With **Enable parallax effect**, the image moves as customers scroll.
- **Mobile:** the email field and the **Subscribe** button stack on top of each other.
![Newsletter section on a phone](https://storage.crisp.chat/users/helpdesk/website/-/f/8/b/b/f8bb8da391016800/newsletter-1_1oxb11p.png)

## Settings reference

### General

| Setting | What it does |
| ---- | ---- |
| Color scheme | Sets the colors of the section. You can edit color schemes in Theme settings > Colors. |
| Enable full-width banner | Stretches the section across the full screen width. Turn it off to keep it inside the page margins. |
| Mask overlay opacity | Sets how dark the overlay on the background image is, from 0 % to 90 %. Applies only with a background image. |
| Mask overlay | Sets the color of the overlay on the background image. Applies only with a background image. |
| Text overlay | Sets the text color on top of the background image. Applies only with a background image. |
| Section subheading | Small text above the heading. Leave it empty to hide it. |
| Section heading | The main heading. Leave it empty to hide it. |
| Section description | Short text below the heading. Leave it empty to hide it. |

### Layout

| Setting | What it does |
| ---- | ---- |
| Content alignment | Aligns the text and the form to the Left or Center. |
| Remove padding top | Removes the space above the section. |
| Remove padding bottom | Removes the space below the section. |

### Image

| Setting | What it does |
| ---- | ---- |
| Background image | The image behind the text and the form. |
| Enable parallax effect | Moves the image at a different speed as customers scroll. Appears after you select a background image. |
| Parallax direction | Sets how the image moves: Vertical, Horizontal, or Zoom. Appears when Enable parallax effect is checked. |

### Prominent badge

| Setting | What it does |
| ---- | ---- |
| Text | The badge text. Leave it empty to hide the badge. |
| Accent scheme | Colors the badge with the Main or Extra accent colors. Appears when the badge has text. |
| Position | Places the badge on the Left or Right. Appears when the badge has text. |
| Shape | Sets the badge shape: Star, Diamond, or Asterisk. Appears when the badge has text. |

## Troubleshooting

**The mask overlay and text colors don't change anything.**
These settings apply only when the section has a **Background image**. Add an image under **Image**.

**I can't find the parallax setting.**
**Enable parallax effect** appears only after you select a **Background image**.

**Where do I find the people who subscribed?**
In your Shopify admin, go to **Customers**. Subscribers from this form have the tag "newsletter" and are subscribed to email marketing.

**The text is hard to read on my image.**
Increase **Mask overlay opacity**, or change the **Text overlay** color.

## Related articles

- [Blum Popup](https://doc.ecomx.co/en/article/blum-popup-1b6xhi2/)
- [Blum Custom Section](https://doc.ecomx.co/en/article/blum-custom-section-fmpkw1/)
- [Blum Footer](https://doc.ecomx.co/en/article/blum-footer-xyye0k/)
- [Blum Image Banner](https://doc.ecomx.co/en/article/blum-image-banner-jzf00j/)