Cloudflare Docs
Pages
Visit Pages on GitHub
Set theme to dark (⇧+D)

Known issues

Here are some known bugs and issues with Cloudflare Pages:

  • GitHub and GitLab are currently the only supported Source code hosting tools.
  • Pages currently only supports a single project per repository. Monorepos or repositories with multiple codebases/applications currently cannot deploy more than one project to Pages at a time.
  • Once you have selected a GitHub repository for your Pages application, it cannot be changed. Remove/delete your Pages project and create a new one pointing at a different repository if you need to update it.
  • *.pages.dev subdomains currently cannot be changed. If you need to change your *.pages.dev subdomain, delete your project and create a new one.
  • Hugo builds automatically run an old version. To run the latest version of Hugo (for example, 0.80.0), you will need to set an environment variable. Set HUGO_VERSION to 0.80.0 or the Hugo version of your choice.
  • By default, Cloudflare uses Node 12.18.0 in the Pages build environment. If you need to use a newer Node version, refer to the Build configuration page for configuration options.
  • For users migrating from Netlify, Cloudflare does not support Netlify’s Forms and Serverless Functions features.
  • It is currently not possible to add a custom domain with a wildcard, for example, *.domain.com.
  • It is currently not possible to add a custom domain with a Worker already routed on that domain.
  • It is currently not possible to add a custom domain with a Cloudflare Access policy already enabled on that domain.
  • Cloudflare’s Load Balancer does not work with *.pages.dev projects; an Error 1000: DNS points to prohibited IP will appear.
  • A GitHub or GitLab account cannot be attached to more than one Cloudflare account.
  • Functions (beta) does not currently support adding/removing polyfills, so your bundler (for example, Webpack) may not run.
  • When adding a custom domain, the domain may get stuck verifying due to being unable to validate a request for an SSL on that hostname. In order for the SSL to validate, ensure Cloudflare Access or a Cloudflare Worker is allowing requests to the validation path: http://{domain_name}/.well-known/pki-validation/*.

If you have an issue that you do not see listed, let the team know in the Cloudflare Workers Discord. Get your invite at discord.gg/cloudflaredev, and share your bug report in the #pages-general channel.