--- title: "Manage Versions" slug: "manage-versions" tags: ["applications"] status: "update" updated: 2026-10-13T15:32:58Z published: 2026-10-13T15:32:58Z canonical: "docs.unqork.io/manage-versions" --- > ## 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. # Manage Versions The **checkout pill** in the module toolbar displays the current branch or version name. Clicking the pill opens a menu where Creators can switch to any branch or version and access versioning actions. ![Module Builder tab bar showing the checkout pill — a badge displaying the current branch name with a chevron — in the toolbar.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_d76e663f67054074b3c9af2b7cc4134d.png?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) ## Checkout Pill Menu Clicking the checkout pill opens a menu listing all branches for the application, with published versions and every versioning action behind two fly-out rows beneath them. - **Branches** display flat, in alphabetical order. - **Published versions** sit behind the ![FolderTree](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_437e95418763434782823b6045d23806.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Versions** row. Hover the row to open a panel listing them, newest first. Each version shows its version string followed by the version name given at publish, when it has one. - **Search** filters branches and versions together, matching a version by either its version string or its version name. While a search is active, matching versions display inline in the list alongside matching branches, so one search reaches both kinds. Selecting a branch or version switches the working context immediately. ### Versioned Actions Hovering the ![GitBranch](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_fb04c4fc1bbc4dd689c7e639800b4f39.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Versioned Actions** row at the bottom of the menu opens a panel with every action available for the current application: | Action | Description | | --- | --- | | ![GitBranch](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_fb04c4fc1bbc4dd689c7e639800b4f39.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Create Branch...** | Opens the Create Branch dialog, pre-seeded with the branch or version currently checked out. Requires update permission. See [Creating Branches](/unqorkai/docs/creating-branches). | | ![Upload](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_2df9e020f619497ab540803c042c37c4.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Publish...** | Opens the Publish dialog for the current branch. Requires update permission. See [Publishing Branches](/unqorkai/docs/publishing-branches). | | ![GitMerge](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_64e8f70326ed4ba39fbab198d56dd921.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Start Merge...** | Opens the merge workflow with neither side chosen. See [Merging Branches](/unqorkai/docs/merging-branches). | | ![Settings2](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_97bd4b79cd0e4a38883c74908790cd3f.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Manage Versions** | Opens the Manage Versions dialog. | | ![Plus](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_c406fbb606ba4191999368d8f8140154.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Add Dependencies** | Opens the Add Dependency dialog directly. Requires update permission. See [Application Dependencies](/unqorkai/docs/application-dependencies). | | ![Layers](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_f4673c72461a4e18aa69fdd7830d3e5d.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Manage Dependencies** | Opens the Manage Dependencies dialog. See [Application Dependencies](/unqorkai/docs/application-dependencies). | > [!NOTE] > **Publish...** and **Add Dependencies** only display when a branch is checked out. A published version cannot be published again, and its dependencies are fixed at the versions it pinned, so neither action applies. Switch to a branch to see them. **Manage Dependencies** always displays — on a version it opens read-only, so the pinned dependencies stay viewable. ## Manage Versions Dialog The Manage Versions dialog is the central place for managing branches and published versions. Open it by selecting **Manage Versions** in the menu. The dialog displays a tree of published versions with their branches nested beneath. Each branch's commit history displays inline under the branch row. One search field narrows the entire tree, matching a version by either its version string or its version name; matching entries expand automatically. Versions sort by semantic version number, with `v1.10.0` sorting above `v1.9.0`. ### Version Row Actions Each published version row displays the version string, the version name given at publish when it has one, a **Default** badge if it is the current default version, and a **Current** badge if it is the active working context. The following actions are available from its ![EllipsisVertical](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_653d9f215cbb4161b0a5a658f25a3c06.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) (**ellipsis**): | Action | Description | | --- | --- | | ![ArrowRightLeft](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_11f8341f8c3d4e138eb003003dd5ccb7.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Open** | Switches the working context to this version. Disabled on the version currently in context. | | ![GitBranch](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_fb04c4fc1bbc4dd689c7e639800b4f39.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Create Branch from [version]** | Opens the Create Branch dialog pre-seeded with this version as the source. Requires create permission. See [Creating Branches](/unqorkai/docs/creating-branches). | | ![GitMerge](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_64e8f70326ed4ba39fbab198d56dd921.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Merge…** | Opens the merge workflow with this version as the source. See [Merging Branches](/unqorkai/docs/merging-branches). | | ![CircleCheck](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_1c7ded0829db4f898c0f29826c8ec7b1.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Set as Default** | Sets this version as the default. Only available on versions that are not already the default. Requires update permission. See [Default Version](/unqorkai/docs/default-version). | ### Branch Row Actions Each branch row displays the branch name and a **Current** badge if it is the active working branch. The following actions are available from its ![EllipsisVertical](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_653d9f215cbb4161b0a5a658f25a3c06.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) (**ellipsis**): | Action | Description | | --- | --- | | ![ArrowRightLeft](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_11f8341f8c3d4e138eb003003dd5ccb7.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Open** | Switches the working context to this branch. Not available on the current branch. | | ![GitBranch](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_fb04c4fc1bbc4dd689c7e639800b4f39.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Create Branch from [branch]** | Opens the Create Branch dialog pre-seeded with this branch as the source. Requires create permission. See [Creating Branches](/unqorkai/docs/creating-branches). | | ![GitMerge](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_64e8f70326ed4ba39fbab198d56dd921.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Merge…** | Opens the merge workflow with this branch as the source. See [Merging Branches](/unqorkai/docs/merging-branches). | | ![Upload](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153256_2df9e020f619497ab540803c042c37c4.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Publish…** | Publishes this branch as a new version. Only available on unpublished branches. Requires create permission. See [Publishing Branches](/unqorkai/docs/publishing-branches). | | ![History](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_7638fb388f954394adfc2c9a6b72db0a.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Branch History** | Expands the commit history inline beneath the branch row. Selecting it again collapses the history. See [Branch History](/unqorkai/docs/branch-history). | | ![Trash2](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261013_153257_811fb9c69cec431f834de7ed94bfcf14.svg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A09%3A04Z&se=2026-11-08T19%3A09%3A04Z&sr=c&sp=r&sig=J24hT2o0DWQnSVgkIObJ1lG5AE4M39NwPrV5TQJwpW4%3D) **Delete Branch** | Permanently deletes the branch. Requires delete permission. See [Deleting Branches](/unqorkai/docs/deleting-branches). | --- **Changelog** | Date | Change | | --- | --- | | 2026-09-09 | Pill menu reorganised into two hover fly-outs (Versions, Versioned Actions); Add Dependencies added; Create Branch, Publish and Start Merge reachable without opening Manage Versions. | | 2026-09-08 | Documented the version name displaying beside the version string, and matching in search, in the checkout pill menu and the Manage Versions tree. | | 2026-08-26 | Restored from orphaned EN-8049 commits; updated links to renamed articles (publishing-branches, deleting-branches). | | 2026-08-24 | Updated menu actions order, icons, and branch/version row actions to match current UI. | | 2026-08-24 | Rewritten for the rebuilt versioning experience. Drawer replaced by checkout pill menu and Manage Versions dialog. | | 2026-08-12 | Removed the Compare row actions. | | 2026-07-15 | Initial publication. | Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. A string is an object that represents a sequence of characters. Strings typically hold data represented in text form. An app versioning Merge combines changes from one branch or draft, into another branch, draft, or published version of an application. Semantic HTML uses HTML elements to clearly describe their meaning, rather than just their appearance, to structure web content for better readability and accessibility for both humans and machines. The UI (user interface) is a device's end-user interaction and communication point. It can include display screens, keyboards, and mouse. It is also how a user interacts with your application.