GitHub integration
You can connect each Cloudflare Pages project to a GitHub repository, and Cloudflare will automatically deploy your code every time you push a change to a branch.
Beyond automatic deployments, the Cloudflare GitHub integration lets you monitor, manage, and preview deployments directly in GitHub, keeping you informed without leaving your workflow.
Pages will default to setting your production environment to the branch you first push. If a branch other than the default branch (e.g. main) represents your project's production branch, then go to Settings > Builds > Branch control, change the production branch by clicking the Production branch dropdown menu and choose any other branch.
You can also use preview deployments to preview versions of your project before merging your production branch, and deploying to production. Pages allows you to configure which of your preview branches are automatically deployed using branch build controls. To configure, go to Settings > Builds > Branch control and select an option under Preview branch. Use Custom branches to specify branches you wish to include or exclude from automatic preview deployments.
Every time you open a new pull request on your GitHub repository, Cloudflare Pages will create a unique preview URL, which will stay updated as you continue to push new commits to the branch. Note that preview URLs will not be created for pull requests created from forks of your repository. Learn more in Preview Deployments.
Without any configuration required, you can choose to skip a deployment on an ad hoc basis. By adding the [CI Skip], [CI-Skip], [Skip CI], [Skip-CI], or [CF-Pages-Skip] flag as a prefix in your commit message, and Pages will omit that deployment. The prefixes are not case sensitive.
If you have one or multiple projects connected to a repository (i.e. a monorepo), you can check on the status of each build within GitHub via GitHub check runs ↗.
You can see the checks by selecting the status icon next to a commit within your GitHub repository. In the example below, you can select the green check mark to see the results of the check run.
Check runs will appear like the following in your repository.
If a build skips for any reason (i.e. CI Skip, build watch paths, or branch deployment controls), the check run/commit status will not appear.
You can deploy projects to Cloudflare Workers from your company or side project on GitHub using the Cloudflare Workers & Pages GitHub App ↗.
You can deploy projects to Cloudflare Pages from your company or side project on both GitHub and GitLab.
When authorizing Cloudflare Pages to access a GitHub account, you can specify access to your individual account or an organization that you belong to on GitHub. In order to be able to add the Cloudflare Pages installation to that organization, your user account must be an owner or have the appropriate role within the organization (that is, the GitHub Apps Manager role). More information on these roles can be seen on GitHub's documentation ↗.
You can remove Cloudflare Pages' access to your GitHub repository or account by going to the Applications page ↗ on GitHub (if you are in an organization, select Switch settings context to access your GitHub organization settings). The GitHub App is named Cloudflare Workers and Pages, and it is shared between Workers and Pages projects.
To remove access to an individual GitHub repository, you can navigate to Repository access. Select the Only select repositories option, and configure which repositories you would like Cloudflare to have access to.
To remove Cloudflare Workers and Pages access to your entire Git account, you can navigate to Uninstall "Cloudflare Workers and Pages", then select Uninstall. Removing access to the Cloudflare Workers and Pages app will revoke Cloudflare's access to all repositories from that GitHub account. If you want to only disable automatic builds and deployments, follow the Disable Build instructions.
Note that removing access to GitHub will disable new builds for Workers and Pages project that were connected to those repositories, though your previous deployments will continue to be hosted by Cloudflare Workers.
If you see errors where Cloudflare Pages cannot access your git repository, you should attempt to uninstall and reinstall the GitHub application associated with the Cloudflare Pages installation.
- Go to the installation settings page on GitHub:
- Navigate to Settings > Builds for the Pages project and select Manage under Git Repository.
- Alternatively, visit these links to find the Cloudflare Workers and Pages installation and select Configure:
| Individual | https://github.com/settings/installations |
| Organization | https://github.com/organizations/<YOUR_ORGANIZATION_NAME>/settings/installations |
- In the Cloudflare Workers and Pages GitHub App settings page, navigate to Uninstall "Cloudflare Workers and Pages" and select Uninstall.
- Go back to the Workers & Pages overview ↗ page. Select Create application > Pages > Connect to Git.
- Select the + Add account button, select the GitHub account you want to add, and then select Install & Authorize.
- You should be redirected to the create project page with your GitHub account or organization in the account list.
- Attempt to make a new deployment with your project which was previously broken.