← Back to blog

How to Point a Subdomain to a Cloudflare Pages Site

If you have a site hosted on Cloudflare Pages and want to serve it from a subdomain on a different domain (also on Cloudflare), here's how.

Part 1: Add a CNAME Record

  1. Log into the Cloudflare dashboard
  2. Select your parent domain (e.g. bytejelly.com)
  3. Go to DNS → Records
  4. Click Add Record with the following values:
FieldValue
TypeCNAME
Nameyour subdomain name
Targetyour Pages project domain
Proxy statusDNS only (grey cloud)
TTLAuto
  1. Click Save

Start with proxy status set to grey (DNS only) to avoid SSL conflicts during setup.

Part 2: Add the Custom Domain in Cloudflare Pages

  1. Go to Workers & Pages in the left sidebar
  2. Click on your Pages project
  3. Go to the Custom domains tab
  4. Click Set up a custom domain
  5. Enter your full subdomain (e.g. myapp.bytejelly.com)
  6. Click Continue → Activate domain

Cloudflare will verify the CNAME record and provision SSL automatically. Since both DNS and hosting are on the same Cloudflare account, activation is typically instant but SSL propagation may take a few minutes.

A Note on Proxy Status

When you add the custom domain in Pages, Cloudflare will automatically flip the CNAME from grey (DNS only) to orange (proxied). This is expected and correct — since Cloudflare controls both sides, the proxy works cleanly and gives you CDN and DDoS protection.

You may see a brief 403 error during the few minutes it takes for the SSL certificate to fully provision. Just wait it out.

Verification

Once the custom domain status shows Active in Cloudflare Pages, visit your subdomain in the browser. It should serve the same content as your original Pages domain.