Skip to main content

Sending Domain

By default your newsletters arrive from [email protected]. Add a sending domain and they arrive from an address on your own domain instead, such as [email protected].

A sending domain is set per project and is available on paid plans, the same as newsletter sending itself.

info

A sending domain is for email. A custom domain is for your website. They are separate settings, they use different DNS records, and one does not imply the other. You can use the same domain for both — example.com for mail and www.example.com for the site — but you still configure each one.

Setup

  1. In the editor, open your project → SettingsSending DomainAdd sending domain.
  2. Enter the domain only, without an address in front of it. Both an apex domain such as example.com and a subdomain kept for email such as mail.example.com work. Domains under micropage.sh are rejected.
  3. Save. The page then shows the DNS records to add at your DNS provider: SPF and DKIM records, plus an MX record for the return path.
  4. Add every record exactly as shown, then wait.

Two ways to copy the records out:

  • Copy all records copies the whole set as plain text, one record per line, fields separated by tabs in the order type, name, value, and priority where a record has one. This pastes into a bulk-import field or a spreadsheet.
  • The table below it has a Copy button per row for providers where you add records one at a time.

Verification

Verification runs in the background. You do not need to keep the page open — the status on the screen updates on its own as it changes.

DNS changes take time to spread, so verification is not instant. It can take up to 72 hours depending on your DNS provider. Check records now forces a fresh check if you have just fixed something and don't want to wait for the next automatic one.

Each record carries its own status, and the domain as a whole shows one of:

StatusMeaning
Not startedThe records haven't been seen yet. Normal right after you add the domain.
PendingThe records are being checked.
VerifiedThe domain is ready to send from.
FailedVerification gave up. Compare every record against what your DNS provider actually has, then retry.
Temporary failureThe records were found once but did not check out on the last attempt. Checking continues by itself.

Nothing is blocked or lost while a domain is unverified. Newsletters still send, from [email protected]. The same is true if a domain that was verified later stops verifying — for example if a record is deleted at your DNS provider. Sending falls back to [email protected] rather than failing.

Choosing the sender address

Once the domain is Verified, set the local part — the hello in [email protected] — under Newsletter → Sender settingsSender address. Letters, digits, dots, hyphens, underscores, and plus signs are allowed, starting and ending with a letter or digit, up to 64 characters.

The field is read-only until a sending domain is verified. It is set per newsletter form, so two lists on the same project can send from different addresses on the same domain.

The Sender name and Reply-to address on the same screen work regardless of whether you have a sending domain. See Newsletter.

Changing or removing a domain

Change domain replaces the domain and starts verification again from scratch with a new set of DNS records. Remove domain clears it, and sending reverts to [email protected].

Neither affects newsletters that have already gone out.

Troubleshooting

Status stays on "Not started"

  • Confirm the records exist at the provider that is actually authoritative for the domain. If you recently moved nameservers, records added at the old provider are invisible.
  • Some providers append the domain to the Name field automatically. Entering send.example.com where the provider expects send produces send.example.com.example.com.

Status is "Failed"

  • The error list under the status names the records that did not check out. Compare value for value; a trailing character or a missing quote is enough to fail a TXT record.
  • After correcting a record, click Check records now.

Verified, but mail still arrives from [email protected]

  • The Sender address under Newsletter → Sender settings has not been set for that newsletter form. A verified domain on its own does not change the sender.

Availability

Sending domains require a paid plan (Pro or Pro+), the same as newsletter sending. On Free you can collect subscribers but not email them, so the screen shows an upgrade prompt instead. See the pricing page.