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.
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.
   

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.

API Reference

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