Merging and Pull Requests

Last modified: November 1st, 2023

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

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

Merging and Pull Requests are two modes of publishing from a branch site. To use these workflow options, you will need a connected Publish Branch. Read more about connecting a Publish Branch or creating a project to get started.

Merging#

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. You and your team should make changes to the 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.

A screenshot of the CloudCannon app shows the Publishing page with a button to Publish pending changes.

Pull Requests#

Pull Requests require approval from another team member 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. You and your team should make changes to the 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.
A screenshot of the CloudCannon app shows the Publishing page with fields to describe changes and a Create Pull Request button.

Reviewing a Pull Request#

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

To review 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.
A screenshot of the CloudCannon app shows the Publishing page with a button to Merge or Close a Pull Request and a list of changes.

Related Articles

Open in a new tab