Skip to content

Commit bd20758

Browse files
Fill in common field descriptions and add an example with explanantion
1 parent 1ddae54 commit bd20758

File tree

1 file changed

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

1 file changed

+25
-2
lines changed

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

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,18 +6,41 @@ 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-
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. As an authoritative DNS provider, Cloudflare can help you manage your 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/zone-setups/), you can use Cloudflare to manage your DNS records.
1414

1515
## DNS records table
1616

1717
DNS records have different types and each type serve 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/).
1818

1919
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.
2020

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>
43+
2144
## DNS records quota
2245

2346
There is a limit to the number of records you can create on a single <GlossaryTooltip term="DNS zone">zone</GlossaryTooltip>.

0 commit comments

Comments
 (0)