Move hostnames

Last updated Apr 16, 2026 As a SaaS provider, you may want, or have, multiple zones to manage hostnames. Each zone can have different configurations or origins, as well as correlate to varying products. You might shift custom hostnames between zones to enable or disable certain features. Cloudflare allows migration within the same account through the steps below:

CNAME

If your custom hostname uses a CNAME record, add the custom hostname to the new zone and update your DNS record to point to the new zone.

Note

If you would like to migrate the custom hostname without end customers changing the DNS target, use apex proxying.

  1. Add custom hostname to your new zone.
  2. Direct your customer to change the DNS record so that it points to the new zone.
  3. Confirm that the custom hostname has validated in the new zone.
  4. Wait for the certificate to validate automatically through Cloudflare or validate it using Domain Control Validation (DCV).
  5. Remove custom hostname from the old zone.

Once these steps are complete, the custom hostname's traffic will route to the second SaaS zone and will use its configuration.

A record

Through Apex Proxying or BYOIP, you can migrate the custom hostname without action from your end customer.

  1. Verify with the account team that your apex proxying IPs have been assigned to both SaaS zones.
  2. Add custom hostname to the new zone.
  3. Confirm that the custom hostname has validated in the new zone.
  4. Wait for the certificate to validate automatically through Cloudflare or validate it using DCV.
  5. Remove custom hostname from the old zone.

Note

The most recently edited custom hostname will be active. For instance, example.com exists on SaaS Zone 1. It is added to SaaS Zone 2. Because it was activated more recently on SaaS Zone 2, that is where it will be active. However, if edits are made to example.com on SaaS Zone 1, it will reactivate on that zone instead of SaaS Zone 2.

Wildcard certificate

If you are migrating custom hostnames that rely on a Wildcard certificate, Cloudflare cannot automatically complete Domain Control Validation (DCV).

  1. Add custom hostname to the new zone.
  2. Direct your customer to change the DNS record so that it points to the new zone.
  3. Validate the certificate on the new zone through DCV.

The custom hostname can activate on the new zone even if the certificate is still active on the old zone. This ensures a valid certificate exists during migration. However, it is important to validate the certificate on the new zone as soon as possible.

Note

Verify that the custom hostname successfully activated after the migration on the Custom Hostnames ↗︎ page.

Was this helpful?

YesNo

On this page

Move hostnames - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/migrating-custom-hostnames/#page","headline":"Move hostnames","description":"Learn how to move hostnames between different zones.","url":"https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/migrating-custom-hostnames/","inLanguage":"en","image":"https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/migrating-custom-hostnames/og.png?v=96a80c5cffcaa319","dateModified":"2026-04-16","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["Migration"]}

description: Learn how to remove custom hostnames for inactive customers. title: Remove custom hostnames image: https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-for-saas/domain-support/remove-custom-hostnames/og.png?v=8d941605854184d7

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/cloudflare-for-platforms/llms.txt
Use this file to discover all available pages before exploring further.