---
title: "How to: Create a Branch"
slug: "how-to-create-a-branch"
updated: 2025-11-18T19:29:16Z
published: 2025-11-18T19:29:16Z
canonical: "docs.unqork.io/how-to-create-a-branch"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to: Create a Branch

Learn how to **create a branch** from a versioned application. enable Creators to modify elements of an application without affecting the live, published version.

> New to application versioning? Get started with our [Introduction to Application Versioning](/v1/docs/intro-to-application-versioning) article.

## Creating a Branch

Creators can build a new branch from the application or Module Builder pages.

To create a branch from the application or Module Builder page:

1. At the top of the page, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/App_Versioning_DraftVersion.png?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A44Z&se=2026-11-14T02%3A02%3A44Z&sr=c&sp=r&sig=jApzmX%2ByCIcWuz9sabgtpiWoXb4oaUH9hhhsR%2BOg%2FzQ%3D) **(branch)** icon. The Branch & Version Management pane displays to the right of the page.
2. Click **Create New Branch**.
3. In the **Select Published Version** field, enter or select a published version to branch from. This version acts as the base for the branch.
4. The **Select Branch** field updates to `Create New Branch From Published Version`.

> Learn how to create a branch from a branch in our [How to: Create a Branch From a Branch](/v1/docs/how-to-create-a-branch-from-a-branch) Article.
5. In the **Branch Name*** field, enter a name for your new branch. Branch names can only be 25 characters long and contain letters, numbers, periods, and dashes. ![Form for creating a new branch with version and branch name fields.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/howToBranchModal.webp?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A44Z&se=2026-11-14T02%3A02%3A44Z&sr=c&sp=r&sig=jApzmX%2ByCIcWuz9sabgtpiWoXb4oaUH9hhhsR%2BOg%2FzQ%3D)
6. Click **Create**.

Creating a branch at the application level opens the new branch application page. When creating a new branch at the module level, the Module Builder remains on the current branch.

> After modifying a branch, Creators can bring their changes back into the original branch or base application version. View our [How to: Merge a Branch](/v1/docs/how-to-merge-a-branch) article.

## Identifying a New Branch

Branches display two colored pills next to the application or module name.

![Interface of a version-control application showing branches and release information.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/howToBranchIdentify.webp?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A44Z&se=2026-11-14T02%3A02%3A44Z&sr=c&sp=r&sig=jApzmX%2ByCIcWuz9sabgtpiWoXb4oaUH9hhhsR%2BOg%2FzQ%3D)

| # | Pill | Description |
| --- | --- | --- |
| 1 | Branch Name (Red Pill) | The name of the current branch. In the Branch & Version Management drawer, this value corresponds to the branch displaying the CURRENT red pill. |
| 2 | Application Version Base (Blue Pill) | The application version the branch is based on. In the Branch & Version Management drawer, this value corresponds to the application version displaying the BASE blue pill. |

A branch is a copy of modules in an Unqork application that helps Creators work in parallel. Branching an application can seperate in-progress changes from release-ready modules.

In Unqork an application is a program used to perform specific tasks. An application can be one of two types: workflow or module.

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.

Elements are are what you use to build Unqork applications. Elements include modules, workflows, Data Collections, Data Schema, and Record Collections.