Add a Site to your Project

Once you have created a Project, you can add Sites to it. There are two ways to add a Site to your Project: connect an existing branch from your repository, or create a new branch Site through CloudCannon.

Connect an existing branch#

If you already have a branch in your Git Repository that you want to add to your Project as a Site, this is the best option. This includes connecting your main branch or any other pre-existing branch.

1. Click the Projects button in the App Sidebar. CloudCannon will open the Projects Browser.
2. Select the Project to which you want to add a Site by clicking on the Project Card. CloudCannon will open the Project Sites Browser.
3. Click the + Create a Site button. CloudCannon will open the Create a Site page.
4. Enter a name for your Site in the New Site name field. The branch will automatically receive the same name.
5. Select the Use an existing branch option.
6. Select the branch you want to connect using the Branch dropdown. CloudCannon automatically populates this using the branches in your Git Repository.
7. Click the Create Site button.

CloudCannon will create a new Site in your Project.

Create a new branch Site#

You can create a new branch Site from an existing Site in your Project. By allowing your team members to create Sites via branching in CloudCannon, you can enable them to work more independently and limit the number of people that require access to your Git Provider.

Branching from the Main Branch

To use this branching method, you must have set a Main Branch for your Project. For more information, please read our documentation on setting the Main Branch.

1. Click the Projects button in the App Sidebar. CloudCannon will open the Projects Browser.
2. Select the Project to which you want to add a Site by clicking on the Project Card. CloudCannon will open the Project Sites Browser.
3. Click the + Create a Site button. CloudCannon will open the Create a Site page.
4. Enter a name for your Site in the New Site name field. The branch will automatically receive the same name.
5. Select the Create a new branch option. CloudCannon will automatically populate the Source branch field with your Main Branch.
6. (Optional.) Enter a name for your new branch in the New branch name field, if it should be different to the Site name.
7. Click the Create Site button.

CloudCannon will create a new Site in your Project. Once you have made changes on the branch Site, you can publish them back to the main branch. For more information, read our documentation on merging and Pull Requests.

Branching from another Site

You can also create a branch from another branched Site. When the branch Site is published, the changes will push back into the Site it was branched from. This option requires Allow all branching to be enabled.

To branch from an existing Site:

1. Click the Projects button in the App Sidebar. CloudCannon will open the Projects Browser.
2. Select the Project to which you want to add a Site by clicking on the Project Card. CloudCannon will open the Project Sites Browser.
3. Find the Site you want to branch from in the Project Sites Browser and open the Context Menu by clicking the three-dot icon on the top right Site card.
4. Select the Branch Site option from the Context Menu. CloudCannon will open the Create a Site page.
5. Enter a name for your Site in the New Site name field. The branch will automatically receive the same name.
6. Select the Create a new branch option. CloudCannon will automatically populate the Source branch field with the Site you wanted to branch from.
7. (Optional.) Enter a name for your new branch in the New branch name field, if it should be different to the Site name.
8. Click the Create Site button.

CloudCannon will create a new Site in your Project.