Merging and Pull Requests

Working with a specific static site generator?
Customize CloudCannon's documentation to suit your SSG.

Astro

Bridgetown

Docusaurus

Eleventy

Gatsby

Hugo

Jekyll

Lume

MkDocs

Next.js

Nuxt

Static

SvelteKit

Custom

Great! We'll show you documentation relevant to .
You can change this any time using the dropdown in the navigation bar.

Merge Immediately#

Merging is a straightforward method to push changes to your Publish Branch immediately. Your team members can publish changes from a branch site to the Publish Branch without approval. This mode is great for small teams or when you want less overhead.

To use merging:

1. Make changes to a branched site.
2. Once you have saved your changes, click the Publish button in the sidebar of the branched site.
3. On the Publishing page, click the Publish button.

CloudCannon will push your changes to your Publish Branch immediately.

Pull Requests#

Pull Requests require approval before changes can be merged with your Publish Branch. You can also configure Pull Requests to trigger external builds and workflows.

To use Pull Requests:

1. Make changes to a branched site.
2. Once you have saved your changes, click the Publish button in the sidebar of the branched site.
3. On the Publishing page, edit the title and description of the Pull Request to provide context for the reviewer.
4. Click the Create Pull Request button.

Merging a Pull Request#

Once you or a team member have made a Pull Request, someone must review it before merging.

By default, anyone with the appropriate permissions can merge a Pull Request. However, you can set up additional restrictions to control who is allowed to merge a Pull Request through your Git provider. For more information about permissions, please read our documentation on Permission Groups.

To merge a Pull Request:

1. Click the Publish Pending button in the sidebar of the branched site.
2. Review the changes made to the site. Changes should be summarized in the Pull Request description, and a complete list will be visible under the Changes tab.
3. Click the Merge button to merge the changes to the Publish Branch or the Close button to reject the changes. If you close the Pull Request, the branch site will retain all changes until a team member updates the content or deletes the site.