From a9113a74611fa8176bb6c46fc598d835ef2ed0c0 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 20 Nov 2025 18:22:07 +0000 Subject: [PATCH 1/5] AI-assited: create and apply partial with matrix --- src/content/docs/dns/zone-setups/index.mdx | 9 +++++++- .../dns/zone-setups/subdomain-setup/index.mdx | 6 ++++++ .../subdomain-setup/setup/index.mdx | 15 +++---------- .../partials/dns/subdomain-setup-matrix.mdx | 21 +++++++++++++++++++ 4 files changed, 38 insertions(+), 13 deletions(-) create mode 100644 src/content/partials/dns/subdomain-setup-matrix.mdx diff --git a/src/content/docs/dns/zone-setups/index.mdx b/src/content/docs/dns/zone-setups/index.mdx index 28f8322270dae94..e47fd0332500d95 100644 --- a/src/content/docs/dns/zone-setups/index.mdx +++ b/src/content/docs/dns/zone-setups/index.mdx @@ -5,13 +5,20 @@ sidebar: order: 3 --- -import { Details } from "~/components" +import { Details, Render } from "~/components" When using Cloudflare DNS, you have a few options for your DNS zone setup: * [Full setup](/dns/zone-setups/full-setup/) (most common): Use Cloudflare as your primary DNS provider and manage your DNS records on Cloudflare. * [Partial (CNAME) setup](/dns/zone-setups/partial-setup/): Keep your primary DNS provider and only use Cloudflare's reverse proxy for individual subdomains. * [Subdomain setup](/dns/zone-setups/subdomain-setup/): With your apex domain (`example.com`) on a partial or full setup, independently manage the settings for a specific subdomain (`blog.example.com`) within a separate zone and, potentially, a separate account. + +
+ + + +
+ * [Zone transfers](/dns/zone-setups/zone-transfers/): Use Cloudflare and another DNS provider together across your entire zone to increase availability and fault tolerance. DNS records will be transferred between providers using [AXFR](https://datatracker.ietf.org/doc/html/rfc5936) or [IXFR](https://datatracker.ietf.org/doc/html/rfc1995). :::note diff --git a/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx b/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx index 20700fa96a80cf6..fa973c340c56a80 100644 --- a/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx +++ b/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx @@ -23,6 +23,12 @@ You might use this setup when you want to share access to a specific subdomain's Subdomain setups are also useful when different subdomains require entirely different settings. For example, you may have different requirements for `docs.example.com`, `blog.example.com`, and `community.example.com`. +:::note[Setup compatibility] + +The availability of subdomain setups depends on the combination of parent and child zone configurations. Review the [available setups](/dns/zone-setups/subdomain-setup/setup/#available-setups) to understand which combinations are supported. + +::: + ## Availability diff --git a/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx b/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx index 4e623a545e740a2..42c02a05b67d161 100644 --- a/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx +++ b/src/content/docs/dns/zone-setups/subdomain-setup/setup/index.mdx @@ -36,18 +36,9 @@ Subdomain setup is only available for Enterprise accounts. If you only want to c ## Available setups -The availability of different setups will depend on both the parent zone setup and the setup used for the child zone. A child zone holds DNS management for a delegated subdomain. - -| Parent zone | Child zone | Available | -| ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------- | -| [Full](/dns/zone-setups/full-setup/) or [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | [Full](/dns/zone-setups/full-setup/) | Yes | -| [Full](/dns/zone-setups/full-setup/) or [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | Yes | -| [Full](/dns/zone-setups/full-setup/) or [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | [Partial](/dns/zone-setups/partial-setup/) | No | -| [Partial](/dns/zone-setups/partial-setup/) | [Full](/dns/zone-setups/full-setup/) | Yes | -| [Partial](/dns/zone-setups/partial-setup/) | [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | Yes | -| [Partial](/dns/zone-setups/partial-setup/) | [Partial](/dns/zone-setups/partial-setup/)\* | Yes | - -:::caution[* Subdomain zones in partial setup are not delegated] + + +:::caution[Subdomain zones in partial setup are not delegated] Subdomains using a partial setup represent an exception in the sense that delegation does not apply in this context. As explained in the dedicated [Partial (CNAME) setup section](/dns/zone-setups/partial-setup/), this setup is intended to simply proxy individual subdomains through Cloudflare. For completeness, however, this is listed as an option in this table and the [how-to guide](/dns/zone-setups/subdomain-setup/setup/parent-on-partial/) has detailed explanation on how to achieve a subdomain zone using partial setup. ::: diff --git a/src/content/partials/dns/subdomain-setup-matrix.mdx b/src/content/partials/dns/subdomain-setup-matrix.mdx new file mode 100644 index 000000000000000..832c8a54b94f247 --- /dev/null +++ b/src/content/partials/dns/subdomain-setup-matrix.mdx @@ -0,0 +1,21 @@ +--- +params: + - showDetails? +--- + +The availability of different setups will depend on both the parent zone setup and the setup used for the child zone. A child zone holds DNS management for a delegated subdomain. + +| Parent zone | Child zone | Available | +| ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------- | +| [Full](/dns/zone-setups/full-setup/) or [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | [Full](/dns/zone-setups/full-setup/) | Yes | +| [Full](/dns/zone-setups/full-setup/) or [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | Yes | +| [Full](/dns/zone-setups/full-setup/) or [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | [Partial](/dns/zone-setups/partial-setup/) | No | +| [Partial](/dns/zone-setups/partial-setup/) | [Full](/dns/zone-setups/full-setup/) | Yes | +| [Partial](/dns/zone-setups/partial-setup/) | [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | Yes | +| [Partial](/dns/zone-setups/partial-setup/) | [Partial](/dns/zone-setups/partial-setup/) | Yes | + +{props.showDetails && ( + <> + For details, refer to subdomain setup. + +)} From 5f7b81d0d53244e56518a958d46262c0bcde4de6 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 20 Nov 2025 18:22:51 +0000 Subject: [PATCH 2/5] Rename conditional to avoid confusion with Details component --- src/content/docs/dns/zone-setups/index.mdx | 2 +- src/content/partials/dns/subdomain-setup-matrix.mdx | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/docs/dns/zone-setups/index.mdx b/src/content/docs/dns/zone-setups/index.mdx index e47fd0332500d95..6b5f3f436d2a24d 100644 --- a/src/content/docs/dns/zone-setups/index.mdx +++ b/src/content/docs/dns/zone-setups/index.mdx @@ -15,7 +15,7 @@ When using Cloudflare DNS, you have a few options for your DNS zone setup:
- +
diff --git a/src/content/partials/dns/subdomain-setup-matrix.mdx b/src/content/partials/dns/subdomain-setup-matrix.mdx index 832c8a54b94f247..9a62d41ffe5e895 100644 --- a/src/content/partials/dns/subdomain-setup-matrix.mdx +++ b/src/content/partials/dns/subdomain-setup-matrix.mdx @@ -1,6 +1,6 @@ --- params: - - showDetails? + - linkForMore? --- The availability of different setups will depend on both the parent zone setup and the setup used for the child zone. A child zone holds DNS management for a delegated subdomain. @@ -14,7 +14,7 @@ The availability of different setups will depend on both the parent zone setup a | [Partial](/dns/zone-setups/partial-setup/) | [Secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) | Yes | | [Partial](/dns/zone-setups/partial-setup/) | [Partial](/dns/zone-setups/partial-setup/) | Yes | -{props.showDetails && ( +{props.linkForMore && ( <> For details, refer to subdomain setup. From 5179250c0abea811310c42ef95dcc40a7115833d Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Thu, 20 Nov 2025 18:31:03 +0000 Subject: [PATCH 3/5] Overall review and text touch-ups --- src/content/docs/dns/zone-setups/index.mdx | 4 ++-- .../docs/dns/zone-setups/subdomain-setup/index.mdx | 10 +++++----- src/content/partials/dns/subdomain-setup-matrix.mdx | 1 + 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/src/content/docs/dns/zone-setups/index.mdx b/src/content/docs/dns/zone-setups/index.mdx index 6b5f3f436d2a24d..8fbc5f4a76f1b66 100644 --- a/src/content/docs/dns/zone-setups/index.mdx +++ b/src/content/docs/dns/zone-setups/index.mdx @@ -11,9 +11,9 @@ When using Cloudflare DNS, you have a few options for your DNS zone setup: * [Full setup](/dns/zone-setups/full-setup/) (most common): Use Cloudflare as your primary DNS provider and manage your DNS records on Cloudflare. * [Partial (CNAME) setup](/dns/zone-setups/partial-setup/): Keep your primary DNS provider and only use Cloudflare's reverse proxy for individual subdomains. -* [Subdomain setup](/dns/zone-setups/subdomain-setup/): With your apex domain (`example.com`) on a partial or full setup, independently manage the settings for a specific subdomain (`blog.example.com`) within a separate zone and, potentially, a separate account. +* [Subdomain setup](/dns/zone-setups/subdomain-setup/): With your apex domain (`example.com`) on a partial or full setup, independently manage the settings for a delegated subdomain (`blog.example.com`) within a separate zone and, potentially, a separate account. -
+
diff --git a/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx b/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx index fa973c340c56a80..1f2266950e7dae6 100644 --- a/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx +++ b/src/content/docs/dns/zone-setups/subdomain-setup/index.mdx @@ -23,15 +23,15 @@ You might use this setup when you want to share access to a specific subdomain's Subdomain setups are also useful when different subdomains require entirely different settings. For example, you may have different requirements for `docs.example.com`, `blog.example.com`, and `community.example.com`. -:::note[Setup compatibility] +## Availability -The availability of subdomain setups depends on the combination of parent and child zone configurations. Review the [available setups](/dns/zone-setups/subdomain-setup/setup/#available-setups) to understand which combinations are supported. + -::: +:::note[Setup combinations] -## Availability +The availability of different setups depends on both the parent zone setup and the setup used for the child zone. Review the [available setups](/dns/zone-setups/subdomain-setup/setup/#available-setups) to understand what combinations are supported. - +::: ### Access applications diff --git a/src/content/partials/dns/subdomain-setup-matrix.mdx b/src/content/partials/dns/subdomain-setup-matrix.mdx index 9a62d41ffe5e895..72057d6182f7aa1 100644 --- a/src/content/partials/dns/subdomain-setup-matrix.mdx +++ b/src/content/partials/dns/subdomain-setup-matrix.mdx @@ -16,6 +16,7 @@ The availability of different setups will depend on both the parent zone setup a {props.linkForMore && ( <> +
For details, refer to subdomain setup. )} From 7912e76409bbaf59f604568f19acfe6ce31c4678 Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Fri, 28 Nov 2025 14:22:18 +0000 Subject: [PATCH 4/5] Move matrix outside of list and always display --- src/content/docs/dns/zone-setups/index.mdx | 15 ++++++++------- .../partials/dns/subdomain-setup-matrix.mdx | 2 +- 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/src/content/docs/dns/zone-setups/index.mdx b/src/content/docs/dns/zone-setups/index.mdx index 8fbc5f4a76f1b66..ce1d81258f23093 100644 --- a/src/content/docs/dns/zone-setups/index.mdx +++ b/src/content/docs/dns/zone-setups/index.mdx @@ -12,19 +12,18 @@ When using Cloudflare DNS, you have a few options for your DNS zone setup: * [Full setup](/dns/zone-setups/full-setup/) (most common): Use Cloudflare as your primary DNS provider and manage your DNS records on Cloudflare. * [Partial (CNAME) setup](/dns/zone-setups/partial-setup/): Keep your primary DNS provider and only use Cloudflare's reverse proxy for individual subdomains. * [Subdomain setup](/dns/zone-setups/subdomain-setup/): With your apex domain (`example.com`) on a partial or full setup, independently manage the settings for a delegated subdomain (`blog.example.com`) within a separate zone and, potentially, a separate account. - -
- - - -
- * [Zone transfers](/dns/zone-setups/zone-transfers/): Use Cloudflare and another DNS provider together across your entire zone to increase availability and fault tolerance. DNS records will be transferred between providers using [AXFR](https://datatracker.ietf.org/doc/html/rfc5936) or [IXFR](https://datatracker.ietf.org/doc/html/rfc1995). :::note If you run your own authoritative nameservers but still want to benefit from Cloudflare's global anycast network, check out [DNS Firewall](/dns/dns-firewall/). ::: +### Subdomain setup combinations + + + +--- + ## Zone status For details on zone status, consider the [Reference page](/dns/zone-setups/reference/domain-status/). @@ -33,6 +32,8 @@ For details on zone status, consider the [Reference page](/dns/zone-setups/refer If you have a paid plan, make sure not to use pending zones for production traffic. Cloudflare responds to DNS queries for pending zones on the assigned Cloudflare nameserver IPs but there are associated risks, especially if you do not use [zone holds](/fundamentals/account/account-security/zone-holds/). ::: +--- + ## Common use cases and availability If you are unsure of which setup to use, consider the questions below for an overview of common use cases and their correspondence to each setup and [different pricing plans](https://www.cloudflare.com/plans/#overview). diff --git a/src/content/partials/dns/subdomain-setup-matrix.mdx b/src/content/partials/dns/subdomain-setup-matrix.mdx index 72057d6182f7aa1..43962e9e3da0da5 100644 --- a/src/content/partials/dns/subdomain-setup-matrix.mdx +++ b/src/content/partials/dns/subdomain-setup-matrix.mdx @@ -3,7 +3,7 @@ params: - linkForMore? --- -The availability of different setups will depend on both the parent zone setup and the setup used for the child zone. A child zone holds DNS management for a delegated subdomain. +When configuring a subdomain setup, its availability will depend on both the parent zone setup and the setup used for the child zone. A child zone holds DNS management for a delegated subdomain. | Parent zone | Child zone | Available | | ------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------- | From 2289a08b5ddbd25c7ef77f69ff53d0900940f8ff Mon Sep 17 00:00:00 2001 From: Rebecca Tamachiro Date: Fri, 28 Nov 2025 14:28:43 +0000 Subject: [PATCH 5/5] Make #zone-status more relevant by adding a list before linking out --- src/content/docs/dns/zone-setups/index.mdx | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/src/content/docs/dns/zone-setups/index.mdx b/src/content/docs/dns/zone-setups/index.mdx index ce1d81258f23093..a296d2f64b1630a 100644 --- a/src/content/docs/dns/zone-setups/index.mdx +++ b/src/content/docs/dns/zone-setups/index.mdx @@ -26,7 +26,16 @@ If you run your own authoritative nameservers but still want to benefit from Clo ## Zone status -For details on zone status, consider the [Reference page](/dns/zone-setups/reference/domain-status/). +The possible statuses for a zone are the following: + +- Initializing +- Pending +- Active +- Moved +- Deleted +- Purged + +For details on each status and how a zone can transition from one status to the other, consider the [Reference page](/dns/zone-setups/reference/domain-status/). :::caution[Do not use pending zones in production] If you have a paid plan, make sure not to use pending zones for production traffic. Cloudflare responds to DNS queries for pending zones on the assigned Cloudflare nameserver IPs but there are associated risks, especially if you do not use [zone holds](/fundamentals/account/account-security/zone-holds/).