From 9a216957f2d2d6b894aa6f743c5a39a7af1a63c5 Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Tue, 28 Apr 2026 11:27:50 +0200 Subject: [PATCH 1/8] [SaaS] Specify CA selection for enterprise customers only Clarified that only enterprise customers can select the certificate authority (CA) for issuing certificates. PCX-21137 --- .../cloudflare-for-platforms/create-custom-hostname.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx index 5734dd54f9b5277..0f22ec5e3a14493 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx @@ -13,7 +13,7 @@ import { DashButton } from "~/components"; 3. Add your customer's hostname `app.customer.com` and set the relevant options, including: - The [minimum TLS version](/ssl/reference/protocols/). - Defining whether you want to use a certificate provided by Cloudflare or [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/). - - Selecting the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate. + - Enterprise customers can select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate. - Choosing the [validation method](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/). - Whether you want to **Enable wildcard**, which adds a `*.` SAN to the custom hostname certificate. For more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority). - Choosing a value for [Custom origin server](/cloudflare-for-platforms/cloudflare-for-saas/start/advanced-settings/custom-origin/). From 6b37f09eaccdb54d6020bb9e43815d7877179662 Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Tue, 28 Apr 2026 11:42:20 +0200 Subject: [PATCH 2/8] [SaaS] Specify CA parameter usage for Enterprise customers Clarified that only Enterprise customers can use the `certificate_authority` parameter when creating a custom hostname. PCX-21137 --- .../cloudflare-for-platforms/create-custom-hostname-api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx index c72ac1bf7f7c156..dcbbb7a9baa43ee 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx @@ -4,7 +4,7 @@ --- 1. To create a custom hostname using the API, use the [Create Custom Hostname](/api/resources/custom_hostnames/methods/create/) endpoint. - + * Only Enteprise customer can use the `certificate_authority` parameter to specify a CA. * You can leave the `certificate_authority` parameter empty to set it to "default CA". With this option, Cloudflare checks the CAA records before requesting the certificates, which helps ensure the certificates can be issued from the CA. 2. For the newly created custom hostname, the `POST` response may not return the DCV validation token `validation_records`. It is recommended to make a second [`GET` command](/api/resources/custom_hostnames/methods/list/) (with a delay) to retrieve these details. From 18cf6c27feb9f705b42a7f4d4b94d09f0fa28793 Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Tue, 28 Apr 2026 11:45:04 +0200 Subject: [PATCH 3/8] Update documentation for custom hostname API Added a reference to the plans documentation for Enterprise customers regarding the `certificate_authority` parameter. --- .../cloudflare-for-platforms/create-custom-hostname-api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx index dcbbb7a9baa43ee..fe292ad4b0d8240 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx @@ -4,7 +4,7 @@ --- 1. To create a custom hostname using the API, use the [Create Custom Hostname](/api/resources/custom_hostnames/methods/create/) endpoint. - * Only Enteprise customer can use the `certificate_authority` parameter to specify a CA. + * Only Enteprise customer can use the `certificate_authority` parameter to specify a CA, see [plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/). * You can leave the `certificate_authority` parameter empty to set it to "default CA". With this option, Cloudflare checks the CAA records before requesting the certificates, which helps ensure the certificates can be issued from the CA. 2. For the newly created custom hostname, the `POST` response may not return the DCV validation token `validation_records`. It is recommended to make a second [`GET` command](/api/resources/custom_hostnames/methods/list/) (with a delay) to retrieve these details. From a4ba2f81484a6bd685be1937fa8ec98bbfd40965 Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Tue, 28 Apr 2026 11:49:04 +0200 Subject: [PATCH 4/8] Refactor custom hostname options for clarity Reorganized and clarified options for adding a custom hostname, including validation method, custom origin server, and certificate management details. --- .../cloudflare-for-platforms/create-custom-hostname.mdx | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx index 0f22ec5e3a14493..cb413b8872c2a21 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx @@ -12,9 +12,8 @@ import { DashButton } from "~/components"; 2. Select **Add Custom Hostname**. 3. Add your customer's hostname `app.customer.com` and set the relevant options, including: - The [minimum TLS version](/ssl/reference/protocols/). - - Defining whether you want to use a certificate provided by Cloudflare or [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/). - - Enterprise customers can select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate. - - Choosing the [validation method](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/). - - Whether you want to **Enable wildcard**, which adds a `*.` SAN to the custom hostname certificate. For more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority). - - Choosing a value for [Custom origin server](/cloudflare-for-platforms/cloudflare-for-saas/start/advanced-settings/custom-origin/). + - Select the [validation method](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/). + - Define a [Custom origin server](/cloudflare-for-platforms/cloudflare-for-saas/start/advanced-settings/custom-origin/). + - Enterprise customers can also select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate, [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/), or enable wildcard which adds a `*.` SAN to the custom hostname certificate (for more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority). See [plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/) + 4. Select **Add Custom Hostname**. From 5fdf31f9225a81b7c8eaf200a0a333b4ed716021 Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Tue, 28 Apr 2026 11:52:57 +0200 Subject: [PATCH 5/8] Update API documentation for custom hostname creation Clarified the usage of the `certificate_authority` parameter and added information about custom certificates and wildcard certificates. --- .../cloudflare-for-platforms/create-custom-hostname-api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx index fe292ad4b0d8240..8e5d1574f1386d7 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx @@ -4,7 +4,7 @@ --- 1. To create a custom hostname using the API, use the [Create Custom Hostname](/api/resources/custom_hostnames/methods/create/) endpoint. - * Only Enteprise customer can use the `certificate_authority` parameter to specify a CA, see [plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/). + * Only Enteprise customer can use the `certificate_authority` parameter to specify a CA, the `custom_certificate`/`custom_cert_bundle` to upload a custom certificate or `wildcard` to create a wildcard certificate. See [plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/). * You can leave the `certificate_authority` parameter empty to set it to "default CA". With this option, Cloudflare checks the CAA records before requesting the certificates, which helps ensure the certificates can be issued from the CA. 2. For the newly created custom hostname, the `POST` response may not return the DCV validation token `validation_records`. It is recommended to make a second [`GET` command](/api/resources/custom_hostnames/methods/list/) (with a delay) to retrieve these details. From c5848994316ccabf27905e959d99eae381cc804f Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Wed, 20 May 2026 01:07:25 +0200 Subject: [PATCH 6/8] Fix typo in custom hostname API documentation --- .../cloudflare-for-platforms/create-custom-hostname-api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx index 8e5d1574f1386d7..f47bed7ebf204e0 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname-api.mdx @@ -4,7 +4,7 @@ --- 1. To create a custom hostname using the API, use the [Create Custom Hostname](/api/resources/custom_hostnames/methods/create/) endpoint. - * Only Enteprise customer can use the `certificate_authority` parameter to specify a CA, the `custom_certificate`/`custom_cert_bundle` to upload a custom certificate or `wildcard` to create a wildcard certificate. See [plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/). + * Only Enterprise customers can use the `certificate_authority` parameter to specify a CA, the `custom_certificate`/`custom_cert_bundle` to upload a custom certificate or `wildcard` to create a wildcard certificate. See [Plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/). * You can leave the `certificate_authority` parameter empty to set it to "default CA". With this option, Cloudflare checks the CAA records before requesting the certificates, which helps ensure the certificates can be issued from the CA. 2. For the newly created custom hostname, the `POST` response may not return the DCV validation token `validation_records`. It is recommended to make a second [`GET` command](/api/resources/custom_hostnames/methods/list/) (with a delay) to retrieve these details. From 909e53d7f3fb93c32bafa322c09bd158aadeec5c Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Wed, 20 May 2026 01:09:18 +0200 Subject: [PATCH 7/8] Fix capitalization of 'Plans' in documentation --- .../cloudflare-for-platforms/create-custom-hostname.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx index cb413b8872c2a21..0e2c8ba2459c9b2 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx @@ -14,6 +14,6 @@ import { DashButton } from "~/components"; - The [minimum TLS version](/ssl/reference/protocols/). - Select the [validation method](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/). - Define a [Custom origin server](/cloudflare-for-platforms/cloudflare-for-saas/start/advanced-settings/custom-origin/). - - Enterprise customers can also select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate, [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/), or enable wildcard which adds a `*.` SAN to the custom hostname certificate (for more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority). See [plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/) + - Enterprise customers can also select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate, [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/), or enable wildcard which adds a `*.` SAN to the custom hostname certificate (for more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority). See [Plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/) 4. Select **Add Custom Hostname**. From c1e829f7fc0fcd025365d974ad98f23faf2bd0e6 Mon Sep 17 00:00:00 2001 From: Nic <123965403+ngayerie@users.noreply.github.com> Date: Wed, 20 May 2026 14:57:08 +0200 Subject: [PATCH 8/8] Fix formatting in custom hostname documentation --- .../cloudflare-for-platforms/create-custom-hostname.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx index 0e2c8ba2459c9b2..23df4bdaeba9e74 100644 --- a/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx +++ b/src/content/partials/cloudflare-for-platforms/create-custom-hostname.mdx @@ -14,6 +14,6 @@ import { DashButton } from "~/components"; - The [minimum TLS version](/ssl/reference/protocols/). - Select the [validation method](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/issue-and-validate/validate-certificates/). - Define a [Custom origin server](/cloudflare-for-platforms/cloudflare-for-saas/start/advanced-settings/custom-origin/). - - Enterprise customers can also select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate, [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/), or enable wildcard which adds a `*.` SAN to the custom hostname certificate (for more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority). See [Plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/) + - Enterprise customers can also select the [certificate authority (CA)](/ssl/reference/certificate-authorities/) that will issue the certificate, [upload a custom certificate](/cloudflare-for-platforms/cloudflare-for-saas/security/certificate-management/custom-certificates/uploading-certificates/), or enable wildcard which adds a `*.` SAN to the custom hostname certificate (for more details, refer to [Hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority)). See [Plans](/cloudflare-for-platforms/cloudflare-for-saas/plans/). 4. Select **Add Custom Hostname**.