Skip to content

Commit 97594c5

Browse files
[DNS] Adjust email record examples and explain zone apex (#19132)
* Make email records example more complete * Remove 'route through' from send-and-receive-email steps * Add detailed explanation of zone apex and reorder concepts
1 parent 2556862 commit 97594c5

File tree

3 files changed

+74
-13
lines changed

3 files changed

+74
-13
lines changed

src/content/docs/dns/concepts.mdx

Lines changed: 70 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ head:
99

1010
---
1111

12+
import { Details, Example, GlossaryTooltip } from "~/components";
13+
1214
This page defines and articulates key concepts that are relevant to the Cloudflare DNS service and are used in this documentation. For more concepts and broader descriptions, refer to the [Cloudflare Learning Center](https://www.cloudflare.com/learning/dns/what-is-dns/).
1315

1416
## Domain
@@ -39,12 +41,18 @@ This is important because the performance of such authoritative DNS services det
3941

4042
It is also possible that one same company will use more than one DNS provider. Usually, this relates to making a domain more resilient - if one provider faces an outage, the nameservers operated by the other DNS provider will most likely still be available.
4143

42-
In this context, you can have a primary DNS setup, when you use Cloudflare to manage your DNS records, or a [secondary DNS setup](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/), when your DNS records are managed on a different provider and Cloudflare simply receives zone transfers containing your DNS records.
44+
In this context, you can have a primary DNS setup, when you use Cloudflare to manage your [DNS records](#dns-records), or a [secondary DNS setup](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/), when your DNS records are managed on a different provider and Cloudflare simply receives zone transfers containing your DNS records.
4345

4446
When you have a primary DNS setup, you can either use only Cloudflare (also known as [Full setup](/dns/zone-setups/full-setup/)), or you can use Cloudflare and another provider, where the other provider is the one to receive [outgoing zone transfers](/dns/zone-setups/zone-transfers/cloudflare-as-primary/) from Cloudflare.
4547

4648
Finally, as Cloudflare also works as a [reverse proxy](/fundamentals/concepts/how-cloudflare-works/#how-cloudflare-works-as-a-reverse-proxy), [partial (CNAME) setups](/dns/zone-setups/partial-setup/) can be used when you do not want Cloudflare to be [authoritative](#authoritative-dns) for your domain but you still want to proxy individual subdomains through Cloudflare.
4749

50+
## DNS records
51+
52+
DNS records are instructions that live in the authoritative DNS servers and provide information about a [zone](#zone). This includes what IP address is associated with a particular domain, but can also cover many other use cases, such as directing emails to a mail server or validating ownership of a domain.
53+
54+
For more details about using DNS records within Cloudflare, refer to [Manage DNS records](/dns/manage-dns-records/how-to/create-dns-records/) and [DNS record types](/dns/manage-dns-records/reference/dns-record-types/).
55+
4856
## Zone
4957

5058
DNS zone is an administrative concept used for delegating control over a given domain and its subdomains. Read more in the ["What is a DNS zone?" Learning Center article](https://www.cloudflare.com/learning/dns/glossary/dns-zone/).
@@ -53,11 +61,69 @@ For the purpose of this documentation, keep in mind that each domain added to a
5361

5462
Also, different Cloudflare products and features are configurable at the zone level. Refer to [Fundamentals](/fundamentals/setup/manage-domains/connect-your-domain/#domain-configurations) for details.
5563

56-
## DNS records
64+
### Zone apex
5765

58-
DNS records are instructions that live in the authoritative DNS servers and provide information about a zone. This includes what IP address is associated with a particular domain, but can also cover many other use cases, such as directing emails to a mail server or validating ownership of a domain.
66+
Zone apex refers to the domain or subdomain on which the control of DNS records starts.
5967

60-
For more details about using DNS records within Cloudflare, refer to [Manage DNS records](/dns/manage-dns-records/how-to/create-dns-records/) and [DNS record types](/dns/manage-dns-records/reference/dns-record-types/).
68+
<Details header="Example 1">
69+
<Example>
70+
DNS management for **example.com**:
71+
72+
| Type | Name | Content | Proxy status | TTL |
73+
| ---- | ------- | ------------ | ------------ | ------ |
74+
| A | `blog` | `192.0.2.1` | Proxied | Auto |
75+
76+
Zone apex: `example.com`
77+
78+
Full record name: `blog.example.com`
79+
80+
</Example>
81+
</ Details>
82+
83+
<Details header="Example 2">
84+
<Example>
85+
DNS management for **sub.example.com**:
86+
87+
| Type | Name | Content | Proxy status | TTL |
88+
| ---- | ------- | ------------ | ------------ | ------ |
89+
| A | `blog` | `192.0.2.1` | Proxied | Auto |
90+
91+
Zone apex: `sub.example.com`
92+
93+
Full record name: `blog.sub.example.com`
94+
95+
</Example>
96+
</ Details>
97+
98+
Usually, the zone apex coincides with the <GlossaryTooltip term="apex domain">apex domain</GlossaryTooltip>, as shown in Example 1. Example 2 refers to [subdomain delegation](/dns/zone-setups/subdomain-setup/), which is only available to Enterprise plans.
99+
100+
To create a DNS record at the zone apex, use `@` for the record **Name**. For details, refer to [How to](/dns/manage-dns-records/how-to/create-zone-apex/).
101+
102+
<Details header="Record at the zone apex">
103+
<Example>
104+
DNS management for **example.com**:
105+
106+
| Type | Name | Content | Proxy status | TTL |
107+
| ---- | ------- | ------------ | ------------ | ------ |
108+
| A | `@` | `192.0.2.1` | Proxied | Auto |
109+
110+
Zone apex: `example.com`
111+
112+
Full record name: `example.com`
113+
</Example>
114+
115+
<Example>
116+
DNS management for **sub.example.com**:
117+
118+
| Type | Name | Content | Proxy status | TTL |
119+
| ---- | ------- | ------------ | ------------ | ------ |
120+
| A | `@` | `192.0.2.1` | Proxied | Auto |
121+
122+
Zone apex: `sub.example.com`
123+
124+
Full record name: `sub.example.com`
125+
</Example>
126+
</Details>
61127

62128
## DNSSEC
63129

src/content/partials/dns/add-mx-records.mdx

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,7 @@ If you only need to **receive** emails, Cloudflare offers [Email Routing](/email
99

1010
## Send and receive email
1111

12-
To **send and receive** emails from your domain, you need:
13-
14-
* An SMTP provider.
15-
* To create two DNS records within Cloudflare.
16-
17-
To route emails through Cloudflare and to your mail server:
12+
To **send and receive** emails from your domain, you need an SMTP provider. Then, create two DNS records within Cloudflare, following the steps below:
1813

1914
1. Get the IP address and MX record details from your SMTP provider ([vendor-specific guidelines](/dns/manage-dns-records/reference/vendor-specific-records/)).
2015

src/content/partials/dns/dns-scan-procedure.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,9 @@ Since the quick scan is not guaranteed to find all existing DNS records, you nee
3737
| Type | Name | Content | Proxy status | TTL |
3838
| ---- | ------- | ------------ | ------------ | ------ |
3939
| A | `mail` | `192.0.2.1` | DNS Only | Auto |
40-
| MX | `example.com` | `john.mx.example-server.test` | DNS Only | Auto |
40+
| MX | `example.com` | `5 john.mx.example-server.test` | DNS Only | Auto |
4141
| TXT | `_dmarc` | `"v=DMARC1; p=reject; sp=...` | DNS Only | Auto |
42-
| TXT | `*._domainkey` | `"v=DKIM1; p="` | DNS Only | Auto |
43-
| TXT | `example.com` | `"v=spf1 -all"` | DNS Only | Auto |
42+
| TXT | `*._domainkey` | `"v=DKIM1; k=rsa; p=..."` | DNS Only | Auto |
43+
| TXT | `example.com` | `"v=spf1 ip4:..."` | DNS Only | Auto |
4444

4545
</Details>

0 commit comments

Comments
 (0)