Skip to content

Commit 9167a70

Browse files
[DNS] Dedicated section for proxied CNAME (#23666)
* Create dedicated section for proxied CNAMEs * Add example where other records are not returned if orange CNAME
1 parent 3030612 commit 9167a70

File tree

1 file changed

+30
-3
lines changed

1 file changed

+30
-3
lines changed

src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx

Lines changed: 30 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar:
66

77
---
88

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

1111
This page provides information about some of the different types of DNS records that you can manage on Cloudflare. For guidance on how to add, edit, or delete DNS records, refer to [Manage DNS records](/dns/manage-dns-records/how-to/create-dns-records/).
1212

@@ -107,9 +107,36 @@ These records include the following fields:
107107
* If the **Proxy Status** is **DNS Only**, you can customize the value.
108108
* **Proxy status**: For more details, refer to [Proxied DNS records](/dns/proxy-status/).
109109

110-
You can use CNAME records to point to other CNAME records (`www.example2.com` --> `www.example1.com` --> `www.example.com`), but the final record must point to a hostname with a valid IP address (and therefore a valid A or AAAA record) if this hostname is meant to proxy traffic.
110+
#### Proxied CNAME records
111111

112-
Cloudflare uses a process called CNAME flattening to deliver better performance. This process supports a few features and can interact with [different setups that depend on CNAME records](/dns/cname-flattening/#aspects-to-keep-in-mind). Refer to the [CNAME flattening section](/dns/cname-flattening/) to learn more about this.
112+
Observe the following aspects, especially before changing a CNAME record from <GlossaryTooltip term="proxy status" link="/dns/proxy-status/">proxied</GlossaryTooltip> to DNS-only or vice versa:
113+
114+
- If a hostname is meant to proxy traffic, you can use CNAME records to point to other CNAME records (`www.example2.com` --> `www.example1.com` --> `www.example.com`), but the final record must point to a hostname with a valid IP address (and therefore a valid A or AAAA record). Also, queries for other record types on the same name are not supported.
115+
116+
<Details header="Example">
117+
118+
<Example>
119+
DNS management for **example.com**:
120+
121+
| Type | Name | Content | Proxy status |
122+
| -------- | ------- | ----------------------- | ------------- |
123+
| CNAME | abc | `target.external.test` | DNS Only |
124+
</Example>
125+
126+
<Example>
127+
DNS management for **external.test**:
128+
129+
| Type | Name | Content |
130+
| ------- | --------- | --------------------- |
131+
| A | target | `192.0.2.1` |
132+
| TXT | target | `"some TXT content"` |
133+
</Example>
134+
135+
In this example, a query for TXT in `abc.example.com` will **not** return the TXT content in the target zone.
136+
137+
</Details>
138+
139+
- Cloudflare uses a process called CNAME flattening to deliver better performance. This process supports a few features and can interact with [different setups that depend on CNAME records](/dns/cname-flattening/#aspects-to-keep-in-mind). Refer to the [CNAME flattening section](/dns/cname-flattening/) to learn more about this.
113140

114141
:::note
115142
Specific CNAME record values with traffic proxied through Cloudflare will enable Orange-to-Orange (O2O) routing for the Shopify SaaS provider. Refer to the [Shopify provider guide](/cloudflare-for-platforms/cloudflare-for-saas/saas-customers/provider-guides/shopify/) for more information.

0 commit comments

Comments
 (0)