---
title: "Promotions and Versions Page"
slug: "promotions-and-versions-page"
updated: 2025-11-18T20:06:00Z
published: 2025-11-18T20:06:00Z
canonical: "docs.unqork.io/promotions-and-versions-page"
---

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

# Promotions and Versions Page

The **Promotions and Versions** page displays promotion history for applications in current and target environments. It also displays the default application version for the current environment.

This page contains the following tabs:

- **Promotion History**: Promote an application to a different environment or view a list of promoted applications.
- **Set Default Version**: Select the default application version for the current environment.

> The Promotions and Versions page is only available for versioned applications. Learn more in our [Introduction to Application Versioning](/v1/docs/intro-to-application-versioning) article.

## 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-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%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-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

## Promotions and Versions Page

Promotion HistorySet Default Version

## Promotion History

The **Promotion History** page lets Creators create new promotions or view existing promotions and their dependencies. Creators promote versioned applications to other environments, like QA or Production. After promoting, the promotion displays on the Promotion History table. Target environments also display the promoted application in their Promotion History list.

![Promotion history table displaying sorting and filtering options for version control.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/promotionsVersionsHistory.webp?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

| # | Setting | Description |
| --- | --- | --- |
| 1 | Create New Promotion | Click to open the **Create New Promotion** modal. > Learn more about this modal in the Create New Promotion modal section below. |
| 2 | Sort By | Sort the application by the following values: - **Promotion Date**: Filters by the recent promotion date. This most recent promotion date displays first. This is the default setting. - **Version Promoted**: Sorts by the promotion version. Displays the newest version first. - **Target**: Sorts by the target environment. Displays the environments in alphabetical order. - **User**: Sorts by the user who promoted the application. Displays the list by users in alphabetical order. |
| 3 | Filter By | Filter the list by the promotion **Type** (direction). Types include: - **In**: The application was promoted into the current environment. - **Out**: The application was promoted to the Target environment. - **Both:** The application has been promoted into the current environment and promoted to the Target environment. |
| 4 | Promotion History Table | The Promotion History table lists promotions into and out of the environment. If no promotions exist, then this table does not display. |
|  | ↳ | Promotion Date | The date and time of the promotion. |
| Type | The direction of the promotion. Application direction includes: - **In**: The application was promoted into the current environment. - **Out**: The application was promoted to the Target environment. - **Both:** The application has been promoted into the current environment, and promoted to the Target environment. |
| Target | Displays the environment the application was promoted to. |
| Version Promoted | The application version that was promoted. |
| Dependencies | Displays the total dependencies promoted with the application. If no dependencies are promoted, it displays `—`. |
| Promoted By | Displays the user who promoted the application. Displays `You` if your account promoted the application. |
| Actions | Displays the **View Dependencies** button. Click to open a modal displaying the application’s **Depende**n**cies** list. > Learn more about dependencies in our [Introduction to Dependencies](/v1/docs/introduction-to-dependencies) article. |

## Create a New Promotion Modal

The Create New Promotion modal lets Creators select an existing application version to promote to a target environment. Optional settings include setting the promoted application to be the default version and including dependencies in the promotion.

![Configuration options for promoting an application version in a software environment.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/promotionsVersionsHistoryCreate.webp?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

| # | Setting | Description |
| --- | --- | --- |
| 1 | Select Application Version to Promote | Click to display a drop-down list of application versions that can be promoted. This list is limited to the current application. |
| 2 | Select Target Environment | Select an environment from the drop-down menu. When the promotion is created, the Target environment receives the promoted application. |
| 3 | Make Default Version | After promoting, it sets the promoted application version to be the default version of the application. |
| 4 | Promotion Summary | Displays a summarized view of the promotion, including the application, previous version, and version to promote to. |
| ↳ | Application Name | The name of the Unqork application. |
| Last Version Promoted | Displays the previous promotion version. If this is the application’s first promotion, then this field displays `None`. |
| Version After Promotion | Displays the version to promote. This value matches the **Select Application Version to Promote** value. |
| 5 | Include Data Collections in This Promotion | Select this box to include Data Collections in the promotion. If no Data Collections exist, nothing occurs. |

## Promotion History

The **Set Default Version** tab lets you select the default version of your application for the environment. The default version loads in Express View whenever a context is not provided in the URL. It also sets the version that other applications use if they have the default application set as a dependency. In the Production environment, the default version is the one that is available to end-users. Setting the default version lets you update your end-user experience across any published version without promoting or rolling back your configuration.

Below are the columns you’ll see on this page:

| Column | Description |
| --- | --- |
| Application Name | The name of the versioned application that was promoted. |
| Latest Version | The most recent version that was deployed. |
| Default Version | The version that is set as the default. |
| Select Default Version | If you wish to change the default version, click **Select Default Version** to change it. |
| View | Click this button to view the promoted version. |

### Reverting to a Previous Version

If a recently promoted version introduced an issue into the next environment, Creators must identify and fix it in the Staging environment. Until the fix is completed, it’s desirable to remove the issue from the higher environment. You’ll set the previous stable version as the **Default Version** in the **Set Default Version** tab of the **Promotions and Versions** page. That way, you can rollback or revert to a previous version. This option is available at all environment levels.

> Learn more about Promotion and Version control in our [Introduction to Promoting Versioned Applications](/v1/docs/introductions-to-promotions) article.

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.

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

Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.