# Domains and DNS

You own the domain. Adding one, what each DNS record does, what the verification states mean.

Source: https://jade.email/help/domains/

A Jade account is anchored to one or more domains you own. Every address you hand out lives under a domain. Adding one means proving to Jade, and to the rest of the email world, that the domain really is yours and that mail addressed to it should arrive here.

## What's at Settings → Domains

A list of every domain on your account. Each shows two statuses, because sending and receiving depend on different DNS records and can work independently:

- **Sending** means the DKIM records let Jade sign and send mail from your domain.
- **Receiving** means the MX record routes mail sent to your domain into Jade.

A domain can have one working without the other. Each status reads **ready**, **not set up** (the records aren't there yet), **blocked** (a record exists but is wrong), **checking** (Jade hasn't finished its first check), or **unconfirmed** (Jade hasn't been able to confirm the record yet, for example after a lookup failure).

Expand a domain's DNS records to see the status of each record, and use **Recheck** for an immediate answer after you change something.

## Two ways to add a domain

1. Bring your own

   Type your domain into the **Add New Domain** form and select **Add**. Jade gives you a list of DNS records, showing what each one is and what value to set. You add them at your registrar. Jade re-checks on a regular schedule, and **Recheck** checks immediately; when the records are live, the statuses flip to ready.

2. Buy through Jade

   Select **Buy another domain**. The Entri purchase flow opens. Search for the domain you want, complete the purchase, and Jade configures DNS for you on the spot. The domain shows up ready shortly after registration completes.

## What each DNS record does

Adding a domain produces seven records that Jade asks you to add at your registrar. They're all standard email infrastructure, and Jade doesn't invent any of this. All seven belong in your domain's DNS; they differ in mechanism, not in whether they matter:

- **MX record on `yourdomain.com`** routes incoming mail to Jade's receiving servers. This is what gates receiving: without it, nothing addressed to your domain reaches Jade.
- **CNAME records (DKIM)** are three records, one per DKIM signing key. They publish the public keys Jade uses to cryptographically sign mail you send, so receiving servers can verify the signature. This is what gates sending: without them, Jade can't sign outgoing mail.
- **MX record on `mail.yourdomain.com`** routes mail for the custom MAIL FROM subdomain Jade sends through, including bounce and delivery-status messages.
- **SPF (TXT)** declares which servers are allowed to send mail for your domain, so recipients can verify that mail from Jade is really from you.
- **DMARC (TXT)** is the anti-spoofing policy. It tells receiving servers what to do with mail that fails SPF or DKIM checks (Jade's default policy is `quarantine`).

You don't need to memorize this. Copy each value Jade shows you into the matching record at your registrar and the system does the rest.

## What each record's status means

Every record row in the DNS list carries its own status:

- **Found** means the record resolves and matches what Jade prescribed.
- **Not added yet** means nothing is there. Either the record hasn't been added or it's still propagating.
- **Wrong record type** means the right value exists, but as the wrong kind of record. The common case is an MX value pasted into a TXT field; propagation never fixes this, so recreate it as the type shown.
- **Points elsewhere** means a record of the right type exists at that name but has a different value, such as an MX pointing at another mail provider.
- **Couldn't check** means Jade's last lookup failed. That's Jade's problem, not your DNS; recheck to try again.

DNS record status marks: Found is a solid green mark. Not added yet is a hollow amber ring. Wrong record type and Points elsewhere are solid red marks. Couldn't check is a hollow gray ring. A solid mark means a record exists, right or wrong; a hollow ring means nothing is there or the check failed.

DNS propagation is not instant

After you add the records, your registrar takes a few minutes, sometimes longer, to push the change globally. Jade re-checks on a schedule, and **Recheck** gives an immediate answer. If a record stays at "not added yet" for more than an hour, double-check it at the registrar and look for typos in the value field.

## Verification stuck or failed

Start with **Recheck**, which re-reads your DNS immediately and updates every record's status. If a record still isn't found, a few common reasons:

- **The value went into the wrong record type.** Some registrar forms accept an MX value in a TXT field without complaint. Jade flags this as "wrong record type"; recreate the record as the type shown.
- **The records are correct but the values have extra spaces or quotes.** Most registrars strip these automatically; some don't. Open the record at the registrar and look at the literal value.
- **The CNAME conflicts with another record.** DNS forbids a CNAME alongside other records on the same hostname. If your registrar shows an error when you try to add Jade's CNAME, an existing record on that subdomain is blocking it.
- **The wrong domain.** Make sure you added records to the domain you intended, not a parked or staging variant.
- **The TXT field has length limits.** Most TXT records fit comfortably. If a record won't verify, paste the value into a comparison tool and confirm it's intact at the registrar. Some registrars truncate silently.

The per-record statuses tell you exactly which record needs attention. Fix that one record and recheck, rather than starting over from scratch.

## Buying through Entri

When you select **Buy another domain**, Entri opens a search-and-purchase flow inside Jade. A few notes:

- Pricing and availability come from Entri's registrar partners; Jade doesn't set prices.
- DNS is configured by Entri at purchase time, so a domain you buy this way usually shows ready within minutes of registration completing.

## Screening

Turn on **Screen new addresses** on a domain card. New addresses wait in Screening. See [Screening](https://jade.email/help/screening.md).

## Deleting a domain

Settings → **Domains** → click the domain → **Delete**. This removes the domain from your account: you can't send from it anymore, and incoming mail to addresses under it will start bouncing.

Existing emails that already arrived at inboxes under this domain stay in your account. Deleting the domain doesn't destroy them.

Deleting a domain is hard to undo

You can re-add the same domain later, but the gap between deletion and re-add is downtime. If the domain has any inboxes you're still receiving important mail at, hold off until you're sure.

## A note on email reputation

Sending from a brand-new domain looks suspicious to receivers. The first few messages you send from a freshly-verified domain may end up in spam folders even with SPF, DKIM, and DMARC correctly configured. That's a property of the receiving side, not Jade. Reputation builds over weeks of normal sending; the more transactional and human your mail looks, the faster.
