--- title: "Promoting Applications" slug: "promoting-applications" updated: 2025-09-26T08:35:39Z published: 2025-09-26T08:35:39Z canonical: "docs.unqork.io/promoting-applications" --- > ## 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. # Promoting Applications **Promoting applications** advances them from their current environment level to the next available one. During the [application](/v1/docs/introduction-to-unqork-applications) development process, it's important that you understand the different Unqork environments and their purpose. Each environment is used for a different purpose, like creating your application, testing its functionality, and making it available to your end-user. When you're ready to move an application to the next phase of development, you'll promote it. ## Unqork Environment Levels Unqork environment levels support each phase of the software development life cycle. Environment levels are intended to be used in sequential order. You can only promote to the next available environment level in the sequence. Below is a list of Unqork's available environment levels, their order in the environment sequence, and descriptions of each: | # | Environment Level | Description | Codebase | | --- | --- | --- | --- | | 1 | Staging | Where Unqork Creators configure applications. This non-production environment level is meant for test data only. This level is where you create and update configurations before promoting to QA for testing. Staging is an internal environment level and part of Unqork's cloud infrastructure. Staging offers both a Designer and Express View interface. > [!WARNING] > This non-production environment level hosts test data only. | Staging | | 2 | Quality Assurance (QA) | Where Unqork Creators test and verify processes, artifacts, and ensure applications are built using best practices. QA is an internal environment level and part of Unqork's cloud infrastructure. QA offers both a Designer and Express View interface. > [!WARNING] > This non-production environment level hosts test data only. | QA | | 3 | User Acceptance Testing (UAT) | Where the Creators and end-users can view the latest build. Use this environment level to test your application's end-user experience. This non-production environment hosts test data only. UAT is an internal environment level and part of Unqork's cloud infrastructure. UAT offers both a Designer and Express View interface. > [!WARNING] > This non-production environment level hosts test data only. | UAT | | 4 | Production | This is the live application and the only environment level where end-users can access it. This level is also the only environment level to store live client data. > [!WARNING] > Following SDLC best practices, development should never take place in Production. | Production | > [!NOTE] > Additional environments can also include Pre-Production (Pre-Prod) environment levels. Pre-Prod environments use the Production codebase. The progression order is Staging, QA, UAT, Pre-prod, and Production. Client leads decide the number of environments to use when developing a customer application. ## Promotions Moving your application between these environment levels is called a promotion. It's important to note that you can only promote to the next available environment level in the sequence. For example, from Staging to QA. Here's how application promotions work: | Action | Result | | --- | --- | | Promoting for the first time. | If your application does not exist in the next environment level, the [workspace](/v1/docs/introduction-to-workspaces) is promoted along with the application the first time you promote your application. | | Promoting to the same environment. | If your application exists in the next environment level, your promoted application overwrites its previous version. Unqork also promotes your application to the correct workspace. | | Promoting specific modules. | Modules not promoted remain untouched. Your promoted application uses the existing [modules](/v1/docs/introduction-to-the-module-builder) in the next environment level. | | Promoting when shared modules connect to other applications. | The promotion automatically converts modules to shared modules. If other applications promote to the next environment level, they can still connect to these modules. | | Promoting when shared modules do not connect to other applications. | These modules are promoted as normal application elements instead of shared application elements. | > [!WARNING] > You cannot promote an application that has the same application path as an application already promoted. ## Promoting an Application There are two options for promoting Unqork applications. The first is by using the [Release Management Dashboard UDLC Tool](/v1/docs/release-management-dashboard-tool). The second is promoting your applications individually at the Application level. ### Promoting an Application Using the Release Management Dashboard Tool The best practice for promoting your applications is using the Release Management Dashboard tool. This tool makes it easy to create releases with specific applications, modules, and [Data Collections](/v1/docs/data-collections). Then, you can promote that release, monitor its progress, and view all relevant information. > To learn more about the Release Management Dashboard tool, view our [Release Management Dashboard Tool](/v1/docs/release-management-dashboard-tool) article. ### Promoting an Application at the Application Level You can also promote applications at the Application level. Doing so takes you to the **App Promotion** page, where you can select the environment level where you want to promote it, select elements to promote, and view promotion history. > [!WARNING] > If you use Managed Assets and PDF Templates, you must upload these to each environment level. When promoting an application to the next environment level, you must also promote all other elements and attributes of the application. This includes roles, groups, styles, and Data Collections. To promote your application at the Application level: 1. Navigate to an application you want to promote. 2. At the top right of the Application page, click the **ellipsis** button. 3. From the drop-down, select **Promotions**. You'll navigate to the App Promotion page. [![A static image displaying how to select the Promotion option from the Manage drop-down at the Application level.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appPromotionsButton_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A12Z&se=2026-11-09T04%3A51%3A12Z&sr=c&sp=r&sig=9NzvTVf%2FuKItxYDJovXTfbFglDaccrIEbcNQUoen2JE%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appPromotionsButton.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A12Z&se=2026-11-09T04%3A51%3A12Z&sr=c&sp=r&sig=9NzvTVf%2FuKItxYDJovXTfbFglDaccrIEbcNQUoen2JE%3D) #### App Promotion Page [![A static image displaying the Application Promotion Page](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appPromotionPage_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A12Z&se=2026-11-09T04%3A51%3A12Z&sr=c&sp=r&sig=9NzvTVf%2FuKItxYDJovXTfbFglDaccrIEbcNQUoen2JE%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/appPromotionPage.jpg?sv=2026-02-06&spr=https&st=2026-11-09T03%3A51%3A12Z&se=2026-11-09T04%3A51%3A12Z&sr=c&sp=r&sig=9NzvTVf%2FuKItxYDJovXTfbFglDaccrIEbcNQUoen2JE%3D) You'll find the following attributes on the App Promotion page: | Attribute | Description | | --- | --- | | Set Destination Promotion Environment* | Select the environment level where you'd like to promote your application. This application will be promoted with its entrypoint module, or workflow, and any additional connected [modules](/v1/docs/introduction-to-the-module-builder), [workflows](/v1/docs/introduction-to-workflow), and [Data Collections](/v1/docs/data-collections) you select in the following sections of the page. | | **General App Information** | Information about the application. This information includes: - **App Name**: The application's name. - **App Path**: The application's path. - **Style**: The style associated with the application. - **App ID**: The application's unique identifier. - **App Type**: The application type. Application types can be Module or Workflow. - **Created**: The date and time the application was created. - **Last Modified**: The date and time the application was last modified. | | **Promotion History** | After you promote your application, it displays in Promotion History, along with other previous promotions. Applications promoted from the environment display in the **Out** tab. Those promoted into the environment display in the **In** tab. Use Promotion History to monitor the promotion's progress and determine whether it was successful. This section of the page also displays the following information about the promotion: - **Destination Promotion Environments**: The name of the environment level where the application was promoted. - **Date**: The date and time when the application was promoted. - **Promoted By**: The email address of the user who promoted the application. - **Status**: The status of the promotion. Statuses include **Promotion in Progress**, **Promotion Completed**, and **Promotion Failed**. Below the status, you can view the number of elements included in the promotion. > [!NOTE] > If any element in the application does not successfully promote, the status is **Promotion Failed**. - **View Details**: Click this link to display the promotion details. These details include the elements selected for the promotion. | | **Workflow &** **Module****s to Promote** | Select the workflows and modules you want to promote with the application. | | **Data Model****s & Associated Elements to Promote** | Select the [Data Models](/v1/docs/introduction-to-unqork-data-modeling) and other associated elements you want to promote with the application. | | **Data Collections to Promote** | Select the Data Collections you want to promote with the application. | ## Resources - [Environment Administration Landing Page](/v1/docs/environment) - [Environment Administration](/v1/docs/environment-administration) - [Introduction to the Unqork Development Life Cycle Toolkit](/v1/docs/introduction-to-the-unqork-development-life-cycle-toolkit) 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. Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. 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. 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. 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.