From 5f5de06205989b9a7a582252873a0e42d29562fe Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Tue, 15 Jul 2025 11:54:09 +0100 Subject: [PATCH 1/2] Create dedicated section for proxied CNAMEs --- .../manage-dns-records/reference/dns-record-types.mdx | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx b/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx index eba3f63336f225d..5840214cb651cb9 100644 --- a/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx +++ b/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx @@ -6,7 +6,7 @@ sidebar: --- -import { Details, Render, APIRequest } from "~/components" +import { Details, Render, APIRequest, GlossaryTooltip } from "~/components" 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/). @@ -107,9 +107,13 @@ These records include the following fields: * If the **Proxy Status** is **DNS Only**, you can customize the value. * **Proxy status**: For more details, refer to [Proxied DNS records](/dns/proxy-status/). -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. +#### Proxied CNAME records -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. +Observe the following aspects, especially before changing a CNAME record from proxied to DNS-only or vice versa: + +- 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). + +- 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. :::note 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. From a65c64a68eb93bc467358388b4d00392af77412d Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Tue, 15 Jul 2025 12:17:00 +0100 Subject: [PATCH 2/2] Add example where other records are not returned if orange CNAME --- .../reference/dns-record-types.mdx | 27 +++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx b/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx index 5840214cb651cb9..65cb273fe0d23a1 100644 --- a/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx +++ b/src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx @@ -6,7 +6,7 @@ sidebar: --- -import { Details, Render, APIRequest, GlossaryTooltip } from "~/components" +import { Details, Render, APIRequest, GlossaryTooltip, Example } from "~/components" 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/). @@ -111,7 +111,30 @@ These records include the following fields: Observe the following aspects, especially before changing a CNAME record from proxied to DNS-only or vice versa: -- 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). +- 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. + +
+ + +DNS management for **example.com**: + +| Type | Name | Content | Proxy status | +| -------- | ------- | ----------------------- | ------------- | +| CNAME | abc | `target.external.test` | DNS Only | + + + +DNS management for **external.test**: + +| Type | Name | Content | +| ------- | --------- | --------------------- | +| A | target | `192.0.2.1` | +| TXT | target | `"some TXT content"` | + + +In this example, a query for TXT in `abc.example.com` will **not** return the TXT content in the target zone. + +
- 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.