--- title: "Application Promotions" slug: "application-promotions" tags: ["applications"] updated: 2026-09-14T15:18:04Z published: 2026-09-14T15:18:04Z canonical: "docs.unqork.io/application-promotions" --- > ## 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. # Application Promotions The Application Promotions dialog lets Creators promote an application and its associated dependencies to a target environment. Creators use it to select a destination environment, choose which modules, Data Models, Queries, and Data Collections to include in the promotion, and review the application's promotion history. To open Application Promotions, select the ![EllipsisVertical](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20260914_150414_5800baa16ce84408a188b4c3c9ec85c8.svg?sv=2026-02-06&spr=https&st=2026-11-08T10%3A18%3A00Z&se=2026-11-08T11%3A18%3A00Z&sr=c&sp=r&sig=58sW7qQuKfcK2c9Eytobnas6qVfnKxi%2FQfiCps8bazc%3D) (**ellipsis**) next to an application in the Explorer panel and select ![Rocket](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20260914_150414_da4624ba1392416db1ca2ec4d7effe12.svg?sv=2026-02-06&spr=https&st=2026-11-08T10%3A18%3A00Z&se=2026-11-08T11%3A18%3A00Z&sr=c&sp=r&sig=58sW7qQuKfcK2c9Eytobnas6qVfnKxi%2FQfiCps8bazc%3D) **Promotions**. ## Dialog Fields | Field | Description | | --- | --- | | **Destination Environment** | Required. The target environment for the promotion. The list is populated from the available promotion hosts configured for the environment. | | **Version to Promote** | Version-enabled applications only. The published version to promote. Versioned applications promote a whole version and its pinned dependencies. Dependency sections are not displayed. | | **Promotion History** | Collapsed by default. Expand to view a record of past promotions. Use **Promoted Out** and **Promoted In** to toggle between outgoing and incoming promotions. Each entry displays the environment, version (versioned applications), date, initiating Creator, and status (non-versioned applications). | | **Workflows & Modules to Promote** | Non-versioned applications only. Modules and workflows connected to the application. The application's entrypoint module is marked **Required** and stays selected — it always promotes with the application, so **Select None** cannot clear it. An entrypoint workflow is selected by default but can be cleared, provided the destination environment already has a workflow from an earlier promotion. Modules that belong to another application — and shared modules not connected to this one — are listed without a checkbox: the dependency stays visible, but it never promotes with this application. Promote the owning application separately. Unresolved modules are listed the same way. | | **Data Models & Associated Elements to Promote** | Non-versioned applications only. [Data Models](/unqorkai/docs/data-models-overview) from the application's workspace. Selecting a Data Model automatically includes its associated schemas and modules. Visible only when the data models feature is enabled. | | **Queries to Promote** | Non-versioned applications only. [Query Builder](/unqorkai/docs/query-builder) queries associated with the workspace. Selecting a query automatically includes its dependencies. Visible only when the search service feature is enabled. | | **Data Collections to Promote** | Non-versioned applications only. [Record Collections](/unqorkai/docs/record-collections) associated with the application. | | **Smart Components to Promote** | Non-versioned applications only. [Smart Components](/unqorkai/docs/smart-components-overview) used by the application. | | **BYO Packages to Promote** | Non-versioned applications only. [BYO packages](/unqorkai/docs/bring-your-own-byo-overview) associated with the application. | Use **Select All** or **Select None** in any dependency section to bulk-select or clear items. Rows without a checkbox are never included, so **Select All** cannot add them. ## Promoting an Application To promote an application: 1. From the **Destination Environment** drop-down, select the target environment. 2. For version-enabled applications, from the **Version to Promote** drop-down, select the published version. 3. For non-versioned applications, in each dependency section, select the items to include. 4. Select **Promote App** (or **Promote Version** for version-enabled applications). 5. In the confirmation dialog, confirm the promotion. A confirmation message displays when the promotion is initiated. Creators must have promote permissions to use this feature. When promote permissions are not assigned, the **Promote App** button is disabled. --- **Changelog** | Date | Change | | --- | --- | | 2026-09-09 | Documented the modules listed without a checkbox — owned by another application, shared but unconnected, or unresolved. | | 2026-09-08 | Removed the Set Default Version field — setting the default version now happens in Manage Versions. | | 2026-08-27 | Documented the required entrypoint module and the clearable entrypoint workflow. | | 2026-08-25 | Rewritten: entry point updated from Application Page to Explorer ellipsis; restructured as dialog field table; added version-enabled application flow; added Smart Components, BYO Packages, and Set Default Version fields; capitalized Data Collections. | | 2026-08-13 | Documented promotion history for version-enabled applications — the Version column and the per-source Status behavior. | | 2026-05-04 | Initial reference page created. | 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. Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. A functionality of a software. For example, Copy and Paste is a feature of a computer's operating system. A query lets you retrieve, access, manipulate, and delete data in a database. A query lets you retrieve, access, manipulate, and delete data in a database.