Skip to content

Commit a6008b3

Browse files
[DNS] More intro info to DNS records overview (#18319)
* Add background info paragraph and link out for more * Introduce DNS records table, as well as proxy status and flattening * Fill in common field descriptions and add an example with explanantion * Fix broken link * Text review and adjust setup link to a more introductory page
1 parent c675d6a commit a6008b3

File tree

1 file changed

+31
-2
lines changed
  • src/content/docs/dns/manage-dns-records

1 file changed

+31
-2
lines changed

src/content/docs/dns/manage-dns-records/index.mdx

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,40 @@ sidebar:
66

77
---
88

9-
import { DirectoryListing, FeatureTable, GlossaryTooltip } from "~/components"
9+
import { DirectoryListing, FeatureTable, GlossaryTooltip, Details, Example } from "~/components"
1010

1111
DNS records contain information about your domain and are used to make your website or application available to visitors and other web services.
1212

13-
For background about different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/).
13+
Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. According to your [setup](/dns/get-started/), you can use Cloudflare to manage your DNS records.
14+
15+
## DNS records table
16+
17+
DNS records have different types and each type serves a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/).
18+
19+
When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](/dns/cname-flattening/). These are specific features offered by Cloudflare.
20+
21+
<Details header="Record fields">
22+
- **Type**: Defines the purpose of a record. Different types of record require different information in their corresponding `Content` field.
23+
- **Name**: Identifies the resource that the record resolves to. Depending on the purpose of the record, the value you want to add to this field will also change.
24+
- **Content**: Contains the core value of a record, depending on the record type.
25+
- **TTL**: Controls how long each record is cached by DNS resolvers.
26+
</Details>
27+
28+
<Details header="Example">
29+
30+
<Example>
31+
DNS management for **example.com**:
32+
33+
| Type | Name | Content | Proxy status | TTL |
34+
| ---- | ------- | ------------ | ------------ | ------ |
35+
| A | `blog` | `192.0.2.1` | Proxied | Auto |
36+
37+
In this example, an IP address resolution record of type `A` is indicating that the resources that correspond to the subdomain `blog.example.com` can be reached on the IPv4 address `192.0.2.1`.
38+
39+
Also, as this record is <GlossaryTooltip term="proxy status" link="/dns/manage-dns-records/reference/proxied-dns-records/">proxied</GlossaryTooltip>, Cloudflare automatically defines for how long this information should be cached by DNS resolvers.
40+
</Example>
41+
42+
</Details>
1443

1544
## DNS records quota
1645

0 commit comments

Comments
 (0)