Skip to content

Commit 612bf87

Browse files
Add detailed explanation of zone apex and reorder concepts
1 parent d7bf1a3 commit 612bf87

File tree

1 file changed

+70
-4
lines changed

1 file changed

+70
-4
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

0 commit comments

Comments
 (0)