---
title: "How to: Enable Application Versioning"
slug: "how-to-enable-application-versioning"
updated: 2025-11-18T19:28:27Z
published: 2025-11-18T19:28:27Z
canonical: "docs.unqork.io/how-to-enable-application-versioning"
---

> ## 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: Enable Application Versioning

Learn how to **enable application versioning** and gain the benefits of a version control system in Unqork. Application versioning enables Creators to create and publish branches of an application.

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

## Prerequisites

There are a few considerations to make when using Unqork's application versioning system:

- Once an application is converted to a versioned application, it cannot be reverted to an unversioned application.
- [Library modules](https://docs.unqork.io/Content/A00-Unqork_Platform/A00109-Unqork_Library_Elements.htm) are not supported for versioned applications, including any dependencies. Any shared modules must be added to another application, and that application must be made a dependency.
- Application versioning can be enabled on an application-by-application basis.

## Enable Application Versioning

> [!WARNING]
> Once Application Versioning is enabled, you cannot disable it. The environment style and header, footer, login, and logout modules configured for a versioned application are only applied to the current branch.

Click on the tabs below to learn how to enable application versioning:

New ApplicationExisting Applications

### Enabling Application Versioning for a New Application

To enable Application Versioning when creating a new application:

1. Navigate to a workspace.
2. At the top right of the page, click **+ Create App**.
3. Complete the **App Details** section of the Create App modal.
4. Select the **Advanced Settings** tab.
5. Set **Enable Application Versioning** to ![A toggle switch icon indicating an on state for user interface settings.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/toggledOn.jpg?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A42Z&se=2026-11-14T02%3A02%3A42Z&sr=c&sp=r&sig=2d8aY13t%2BwqWvjEjACuKW5uDujYeCPYspAc45Z5Etq0%3D) (**ON**).

![Settings page for enabling application versioning with important notes and options.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appVerEnable.webp?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A42Z&se=2026-11-14T02%3A02%3A42Z&sr=c&sp=r&sig=2d8aY13t%2BwqWvjEjACuKW5uDujYeCPYspAc45Z5Etq0%3D)
6. Click **Create**. The Enable Application Versioning modal displays.
7. In the **Branch Name** field, enter a name for your initial `0.0.0` version.
8. Click **Confirm**.

### Enabling Application Versioning for an Existing Application![Application settings interface showing data versioning and application versioning options.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/App_Versioning_Toggle_thumb_0_0(1).jpg?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A42Z&se=2026-11-14T02%3A02%3A42Z&sr=c&sp=r&sig=2d8aY13t%2BwqWvjEjACuKW5uDujYeCPYspAc45Z5Etq0%3D)

To enable Application Versioning for your existing applications:

1. Navigate to your application.
2. At the top right of your Application page, click ![ellipsisButtonDummy.jpg](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/ellipsisButtonDummy.jpg?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A42Z&se=2026-11-14T02%3A02%3A42Z&sr=c&sp=r&sig=2d8aY13t%2BwqWvjEjACuKW5uDujYeCPYspAc45Z5Etq0%3D) (**ellipsis**).
3. Select **Settings**.
4. Select the **Advanced Settings** tab.
5. Set **Enable Application Versioning** to ![A toggle switch icon indicating an on state for user interface settings.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/toggledOn.jpg?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A42Z&se=2026-11-14T02%3A02%3A42Z&sr=c&sp=r&sig=2d8aY13t%2BwqWvjEjACuKW5uDujYeCPYspAc45Z5Etq0%3D) (**ON**).
6. Click **Save & Close**. The Enable Application Versioning modal displays.
7. In the **Branch Name** field, enter a name for your initial `0.0.0` version.
8. Click **Confirm**.

> It is important to define dependencies. In case of undefined dependencies, the application will not work and the application might be in a broken state immediately when the application is versioned. Learn how application versioning dependencies work in our [Introduction to Dependencies](/v1/docs/introduction-to-dependencies) article.

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

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.

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.

A modal is a window that appears on top of the content you are currently viewing.