---
title: "How to: Promote a Versioned Application"
slug: "how-to-promote-a-versioned-application"
updated: 2025-11-18T19:30:11Z
published: 2025-11-18T19:30:11Z
canonical: "docs.unqork.io/how-to-promote-a-versioned-application"
---

> ## 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: Promote a Versioned Application

Learn **how to promote a versioned application** between [environment levels](/v1/docs/promoting-applications#unqork-environment-levels). Unlike regular Unqork applications, versioned applications use the Promotions and Versions page to promote applications between environments. Environment levels in Unqork support each phase of the application development process, including Staging, QA (Quality Assurance), UAT (User Acceptance Testing), Production, and so on.

> Learn more about the basic environment levels in our [Unqork Promotions Order](/v1/docs/unqork-promotions-order#environment-levels-in-unqork) article.

## Promoting a Versioned Application

When an application is ready to move to the next environment stage, Creators use the Promotions and Versions page. This page lets Creators create a new promotion, including specifying the application version and the target environment.

> [!WARNING]
> Only published versions can be promoted.

### Access the Promotions and Versions page

To access the **Promotions and Versions** page:

1. Navigate to a versioned application.
2. At the top right, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/ellipsis_grey_icon.png?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A45Z&se=2026-11-14T02%3A02%3A45Z&sr=c&sp=r&sig=4MSN990gWNBkHYVGBB%2FYk8kP0EoAB%2BbwNUOO7W5lzO8%3D) **(ellipsis)** button.
3. Select **Promotions and Versions**. You’ll navigate to the Promotions and Versions page in a new tab. ![Interface of a version-control application showing search and menu options.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/promotionsVersionsAccess.webp?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A45Z&se=2026-11-14T02%3A02%3A45Z&sr=c&sp=r&sig=4MSN990gWNBkHYVGBB%2FYk8kP0EoAB%2BbwNUOO7W5lzO8%3D)

### Promote a Versioned Application

To promote a versioned application:

1. From the Promotions and Versions page, click the **+ Create New Promotion** button.
2. From the **Select Application Version to Promote** drop-down, select a published version. If the version you are looking for does not display, verify that it is published.
3. From the **Select Target Environment** drop-down, select an available environment level. For example, `companyName-qa`. ![Configuration options for promoting an application version in a production environment.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/createNewPromotionModal.webp?sv=2026-02-06&spr=https&st=2026-11-14T01%3A02%3A45Z&se=2026-11-14T02%3A02%3A45Z&sr=c&sp=r&sig=4MSN990gWNBkHYVGBB%2FYk8kP0EoAB%2BbwNUOO7W5lzO8%3D)
4. (Optional) If one or more versions of the application exist in the target environment, set **Make Default Version** to checked.
5. (Optional) If there are Data Collection dependencies for the application, set **Include data collections in this promotion** to checked.
6. Click **Create**.

The promoted application displays in the Promotion History list. The promoted application also displays in the target environment application’s Promotion History list.

The Staging environment is the first level of application building in Unqork. Use it to build, test, and style your applications.

Use your QA (quality assurance) environment to test applications to ensure reliability, security, and functionality before releasing them to the end-user.

Use the UAT (user acceptance testing) environment to realistically test and navigate your applications as end-users would use them.

The Production environment is the final stage of the development process. Use this environment to promote tested and functioning application so your end-user can interact with it.