Add a custom domain to a branch
In this guide, you will learn how to add a custom domain (staging.example.com
) that will point to a specific branch (staging
) on your Pages project.
This will allow you to have a custom domain that will always show the latest build for a specific branch on your Pages project.
First, make sure that you have a successful deployment on the branch you would like to set up a custom domain for.
Next, add a custom domain under your Pages project for your desired custom domain, for example, staging.example.com
.
![Follow the instructions below to access the custom domains overview in the Pages dashboard.](/_astro/pages_custom_domain-1.CiOZm32-_1hDrtY.webp)
To do this:
- Log in to the Cloudflare dashboard ↗.
- In Account Home, go to Workers & Pages.
- Select your Pages project.
- Select Custom domains > Setup a custom domain.
- Input the domain you would like to use, such as
staging.example.com
- Select Continue > Activate domain
![After selecting your custom domain, you will be asked to activate it.](/_astro/pages_custom_domain-2.BTtd80-v_Z2tx6JW.webp)
After activating your custom domain, go to DNS ↗ for the example.com
zone and find the CNAME
record with the name staging
and change the target to include your branch alias.
In this instance, change your-project.pages.dev
to staging.your-project.pages.dev
.
![After activating your custom domain, change the CNAME target to include your branch name.](/_astro/pages_custom_domain-3.DhnYG8VS_Z2cp0T8.webp)
Now the staging
branch of your Pages project will be available on staging.example.com
.