Create a Branch

You can create a branch off of your stack's main (default) branch. The child branch you create inherits all of the content types, entries, assets, languages, extensions, releases, etc. that were part of the main branch as it is.

Note Only stack owners, admins, and developers can create a new branch.

Both developers and content managers can make changes to different copies (branches) of the same stack content in isolation.

Additional Resource For all child branches created subsequently, you can select any other branch apart from main to act as source branch.

To create a branch, log in to your Contentstack account, go to your stack, and perform the following steps:

1. Click the “Settings” icon on the left navigation panel, and select Branches.
   

   Note The main branch is the default branch for any stack.

2. Click on + New Branch.
   Click to enlarge
3. The Create New Branch form appears for you to add the following details:
   
   • Branch ID: Enter a unique ID for the branch, such as “staging” or “development”.
   • Source: Select a branch from the dropdown from which this new branch should inherit data.

   Note By default, the main branch will be the source branch for the first child branch you create.

4. Finally, click Create to save your branch.
   
   Click to enlarge

Note At a time only one branch can be created across an organization. The creation actions triggered for any other branches will remain in the “in-queue” state till the current branch creation action is completed. You can view the status of these actions within the organization's bulk task queue.

To perform operations related to Branches within your stack via API, refer to the following documents:

• Branches collection in our Content Management API
• Branches GET requests in our Content Delivery API
• GraphQL API