Cloudflare Docs
Pages
Cloudflare Docs
Pages
Search icon (depiction of a magnifying glass)
GitHub icon
Visit Pages on GitHub
Set theme to dark (⇧+D)

Known issues

Here are some known bugs and issues with Cloudflare Pages:

​​ Builds and deployment

  • GitHub and GitLab are currently the only supported platforms for automatic CI/CD builds. Direct uploads allow you to integrate your own build platform or upload from your local computer.

  • Monorepos or repositories with multiple codebases/applications currently cannot use the automatic GitHub/GitLab integration to build multiple sites from the same repository. However, Direct Uploads can be used to upload a monorepo as separate Pages projects from your own computer.

  • Incremental builds are currently not supported in Cloudflare Pages.

  • A Direct Upload of a /functions directory does not work (refer to Using Functions in Direct Upload).

​​ Git configuration

  • After you have selected a GitHub/GitLab 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.

  • A GitHub or GitLab account cannot be attached to more than one Cloudflare account.

​​ Build configuration

  • *.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.101.0), you will need to set an environment variable. Set HUGO_VERSION to 0.101.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 feature. An equivalent to Netlify’s Serverless Functions is currently in beta.

​​ Custom Domains

  • 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.

  • 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/*.

​​ Pages Functions

  • Functions (beta) does not currently support adding/removing polyfills, so your bundler (for example, Webpack) may not run.

  • Currently, Durable Objects are not supported in local development mode. To use Durable Objects in your Pages application, deploy a Worker containing a Durable Object. Then add it as a binding to your Pages project as shown in the section above. Support for using Durable Objects in local development is actively being worked on and will be available soon.

​​ Enabling Access on your *.pages.dev domain

If you would like to enable Cloudflare Access] for your preview deployments and your *.pages.dev domain, you must:

  1. Log in to Cloudflare dashboard.
  2. From Account Home, select Pages.
  3. Select your Pages project.
  4. Go to Settings > Enable access policy.
  5. Select Edit on the Acccess policy created for your preview deployments.
  6. In Edit, go to Overview.
  7. In the Subdomain field, delete the wildcard (*) and select Save application. You may need to change the Application name at this step to avoid an error.

At this step, your *.pages.dev domain has been secured behind Access. To resecure your preview deployments:

  1. Go back to your Pages project > Settings > General > and reselect Enable access policy.
  2. Review that two Access policies, one for your *.pages.dev domain and one for your preview deployments (*.<YOUR_SITE>.pages.dev), have been created.

If you have a custom domain and protected your *.pages.dev domain behind Access, you must:

  1. Select Add an application > Self hosted in the Cloudflare Zero Trust dashboard.
  2. Input an Application name and select your custom domain from the Domain dropdown menu.
  3. Select Next and configure your access rules to define who can reach the Access authentication page.
  4. Select Add application.

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.