[relaybell docs › Audience › Email sign-ups (test mode)](https://relaybell.com/docs/email) · [All docs as Markdown](https://relaybell.com/docs.md) · [Index for AI assistants](https://relaybell.com/llms.txt)

# Email sign-ups (test mode)

> Collect email addresses with consent: the subscribe prompt's email box, a sign-up form, double opt-in, unsubscribe and your own sending domain.

relaybell can now collect email addresses next to browser notifications. Email lives in the screens you already use: **Settings → Email**, the **subscribe prompt**, and **Audience**.

> **Test mode.** Right now every email (like the confirmation email) is saved in your **outbox**, not sent. Open it from Settings → Email → **View outbox** to see exactly what your shoppers will get. Sending emails to your list comes later.

## 1. Set up the sender (Settings → Email)

- **Sender name** — shown in the inbox. Empty: your website name.
- **Replies go to** — where replies land. Empty: your account email.
- **Postal address** — required before any real email goes out. Anti-spam laws (such as CAN-SPAM) ask for one in every marketing email; it's shown in the footer.

Until you set up your own domain, emails come from `your-store@mail.relaybell.com`, with replies going to you.

## 2. Collect emails

**In your subscribe prompt:** Audience → Subscribe prompt → **Ask for an email too**. The box is optional for visitors; tapping Allow with an address filled in signs them up for email as well. (Not shown with the "Browser only" prompt style.)

**With a form on any page** (relaybell must be installed on that page):

```html
<div data-relaybell-email-form></div>
```

Change the words with `data-title`, `data-text`, `data-button`, and name the form with `data-form="footer"`. From your own code:

```js
RelayBell.showEmailForm({ target: '#newsletter', title: 'Get 10% off', button: 'Join' });
RelayBell.subscribeEmail('jane@example.com', { form: 'checkout' }); // → { ok, doubleOptIn }
```

The **consent wording** under the box ("Yes, email me news and offers from … Unsubscribe any time.") can be changed in the prompt editor. Every sign-up keeps a record of when, where, which form, the exact wording shown, and the visitor's country — your proof of consent.

## 3. Double opt-in

On by default (Settings → Email → *Ask new contacts to confirm their email*). New contacts get one email with a confirm button and only join your list once they press it. Typos and fake sign-ups never reach your list. An address gets at most 3 confirmation emails a day.

## 4. Unsubscribe and preferences

Every email has an **Unsubscribe** link and a one-click unsubscribe that Gmail, Yahoo and Apple Mail show next to the sender. Unsubscribed, bounced and spam-reported addresses go on your website's **do-not-email list**.

Email and browser notifications are separate: unsubscribing from email doesn't turn notifications off, and blocking notifications doesn't stop emails.

## 5. Your own domain (Advanced)

Settings → Email → **Send from your own domain**: add your domain, copy the DNS records into your DNS provider (GoDaddy, Cloudflare, Bluehost…), then **Check status**. Once verified, emails come from `hello@yourdomain.com`. In test mode the records are placeholders — don't add them yet.

## Safety limits

- Up to 1,000 emails a website a day for now.
- If too many emails bounce (over 5%) or are marked as spam (over 0.1%), relaybell pauses your email automatically and tells you in Settings → Email. Clean your list, then resume.

## In Audience

A subscriber's profile shows their email and its status. Segments have an **Email** condition (*is confirmed* / *is missing*).