--- title: "Repository Branches" slug: "repository-branches" tags: ["repository", "designer repository"] updated: 2024-12-27T20:34:36Z published: 2024-12-27T20:34:36Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Repository Branches ## Overview A branch refers to version control that allows users to work on different versions of a project simultaneously. The purpose of a branch is to enable users to make parallel changes to a project without affecting the main project. Different users can work on separate branches and later merge their changes back into the main project, making it easier for users to work together on complex projects. **This document demonstrates the following topics:** - [Creating a Branch](/v9/docs/repository-branches#creating-a-branch) - [User Actions on the Branch](/v9/docs/repository-branches#user-actions-on-the-branch) - [Merge to Branch](/v9/docs/repository-branches#merging-to-branch) - [Confirming the Merge](/v9/docs/repository-branches#confirming-the-merge) --- ## Creating a Branch When a new branch is created, it includes all the entities from another branch that was utilized as the base to create the new branch. 1. Navigate to the Designer Repository server. Select the [Project Folder](https://documentation.decisions.com/v9/docs/using-the-repository?highlight=Repository%20Server%20-%20Create%20Project) to create the branch. Click on the **CREATE BRANCH** button in the top Action bar. 2. From the drop-down, select a branch (in this case, **Trunk**). Define a **Branch Name** and click on **Create Branch**. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-01_16h40_43.png) 3. Refresh the browser after creating a new branch. 4. The branch will be created by the given name within the Project Folder. Refer to the following image.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2-2024-08-06_15h59_54.png) --- ## User Actions on the Branch The following section demonstrates the actions that can be performed on a Repository Branch. Navigate to the **Designer Repository** > Select the **Project**> Right-click on the **Branch**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/-22024-08-06_16h03_18.png) | Setting Name | Configuration | | --- | --- | | Create or Update Resource | Allows adding a separate entity to the project. Only accepts one file (.decOBj) at a time. | | Create Tag | Append the revisions of the Branch with the given message. | | [Create Branch](/v9/docs/repository-branches#creating-a-branch) | Creates a new branch using this as a base. | | [Merge to Branch](/v9/docs/repository-branches#merge-to-branch) | Allows merging entities into another branch. | | Delete | Deletes the Branch | | Download | | | | Download Project | Downloads the project in a Zip file. | | | Download as of Date | Downloads the Project that was committed at a specific Date and Time. | | | Download Specific Revision | Downloads the Project of a specific revision. Revision ID should be specified. | | Manage | | | | Manage Permission | Allows to Manage the Permissions on folder. | | | Open Containing Folder | Opens the Parent Folder Dashboard (Project Folder). | | | Permissions: Disable [Permissions Inheritance](https://documentation.decisions.com/v9/docs/en/setting-folder-permissions?highlight=permissions%20inheritance) | Disables Permission Inheritance on the Project Folder. | | Open | All actions under this category will open in a new tab. | | | Open Branch Summary | Opens the dashboard of the Branch | | | Open Checkout History | Opens the Checkout History | | | Open Commit History | Opens the Commit history | | | Open Folder | Opens the Dashboard of the current Branch | | | Open Folder View | Opens the branch in a Folder view with all entities listed | | | Open Resources | Shows all the resources from the branch | | [Roll Back](https://documentation.decisions.com/v9/docs/using-the-repository?highlight=Repository%20Server%20-%20Rollback%20Actions) | | | | Rollback Project to Date | This will Rollback the project to the selected date with the latest revision. | | | Rollback Project to Revision | This will Rollback the project to the selected revision. | --- ## Merge to Branch **Merge to Branch** is an action available on the Designer Repository that allows branches to be merged together. 1. Navigate to the Branch you wish to Merge. Right-Click on the **Branch > Merge to Branch**. 2. Select the Destination branch to merge. In this example, **QA** is been merged with **Production**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_16h04_33.png) 3. There are two available options at the bottom of the dialog box for merging entities into a branch. These options are: ### Select From all Entities This option will show all the latest entities from all the revisions of the branch and allows users to manually select the entities they wish to merge. Clicking on **Merge** will merge the selected entities. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_16h06_17.png) ### Select Based on Revisions This option will show all the Revisions IDs associated with each commit. 1. When a revision is selected, all entities from that revision and its subsequent revisions will be selected unless the ‘**Merge Entities from Selected Revision only**’ is Enabled. **E.g.** When revision R-000140 is selected, all entities from R-000140 through R-000143 will be automatically selected. However, if the user wishes only to select entities from R-000140, they should enable the '**Merge Entities from Selected Revisions only**' option. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_16h06_45.png) 2. All the entities from the selected revisions will be displayed in the next window-'**Merge Branch**', which allows users to manually select the entities they wish to merge. Clicking on **Merge** will merge the selected entities. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-08-06_16h07_34.png) --- ## Confirming the Merge After completing the merge, navigate to the merged branch folder. On the **Branch Summary** dashboard, a new **Revision** with the latest date under the **Commit History** section should be visible. The commit message for this revision should indicate that resources from one branch were merged into another branch, such as `Merge resources from [BranchName] branch to [BranchName] branch`.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2-2024-08-06_16h08_33.png) --- ## Feature Changes | Description | Version | Release Date | Developer Task | | --- | --- | --- | --- | | Added two more counts to the Branch Summary tile. | [9.6](https://documentation.decisions.com/v99/docs/version-96x-release-notes) | January 2025 | [DT-042982] | For further information on Repository, visit the [Decisions Forum](https://community.decisions.com/categories/Repository).