Manage a project
In the XM Cloud Deploy app, a project is a collection of environments. Each environment contains its own XM Cloud Content Management (CM) instance.
In the XM Cloud Deploy app, you can create a project using a foundation template or using existing source code. You can also create a project using the Sitecore CLI.
You can change the repository associated with a project, delete a project or change its name.

Change the project repository
A project is linked to a single repository. You can change your project to use a different repository in the same source control account, a different account, or a different source control provider.
Maybe your company is migrating from Azure DevOps to GitHub or you developed a Sitecore solution on your GitHub account and need to transfer code ownership to your customer.
To change the project repository:
-
In the navigation pane of the XM Cloud Deploy app, click Projects.
-
On the Projects page, click the project where you want to change its repository.
-
On the Project page, click Options > Edit project.
-
Choose the repository that you want to link to the project.
-
To choose a repository in a different source control provider, click Edit next to Source control provider.
-
To choose a repository in a different source control account, click Edit next to GitHub account or Azure DevOps account.
-
To choose a different repository in the same account, click Edit next to GitHub repository or Azure DevOps repository. If using Azure DevOps, you can also choose a different Azure DevOps organization or project.
-
-
After choosing the repository you want to link, select the branch that you want to link to each environment.
-
If you want to trigger an automatic deployment every time you push to the linked repository branch, select the Auto deploy on push to repository check box.
-
Click Yes, make the change.
When you change the project repository, the new repository code is not automatically deployed to the related environments. You'll need to create a build and deploy it to your environment.
Change a project name
To change the name of a project:
-
In the navigation pane of the XM Cloud Deploy app, click Projects.
-
On the Projects page, click the project you want to edit.
-
On the Project page, click Options > Edit project.
-
In the Edit project details dialog, change the project name, then click Save.
Delete a project
You can delete a project if it is not needed. You can only delete a project that has no environments.
XM Cloud Components styles and components libraries are linked to a specific project; if you delete your project, the libraries are also deleted. To save your styles and components libraries, make sure you are sharing them with your other projects before deleting the project.
To delete a project:
-
On the Projects page, click the project you want to delete.
-
On the Project page, if there are environments in the project, delete the environments.
-
When the project has no environments, click Options > Delete project.
-
In the Delete project dialog, enter the name of the project, then click Delete.