Skip to content
Cloudflare Docs
We recommend using Cloudflare Workers for new projects. For existing Pages projects, see our migration guide and compatibility matrix.
Close

Redirecting *.pages.dev to a Custom Domain

Learn how to use Bulk Redirects to redirect your *.pages.dev subdomain to your custom domain.

You may want to do this to ensure that your site's content is served only on the custom domain, and not the <project>.pages.dev site automatically generated on your first Pages deployment.

Setup

To redirect a <project>.pages.dev subdomain to your custom domain:

  1. In the Cloudflare dashboard, go to the Workers & Pages page.

    Go to Compute (Workers)
  2. Select your Pages project.

  3. Go to Custom domains and make sure that your custom domain is listed. If it is not, add it by clicking Set up a custom domain.

  4. Go Bulk Redirects.

  5. Create a bulk redirect list modeled after the following (but replacing the values as appropriate):

Source URLTarget URLStatusParameters
<project>.pages.devhttps://example.com301
  • Preserve query string
  • Subpath matching
  • Preserve path suffix
  • Include subdomains
  1. Create a bulk redirect rule using the list you just created.

To test that your redirect worked, go to your <project>.pages.dev domain. If the URL is now set to your custom domain, then the rule has propagated.