--- title: "Unqork Application Versions" slug: "unqork-application-versions-1" updated: 2025-11-19T14:45:42Z published: 2025-11-19T14:45:42Z canonical: "docs.unqork.io/unqork-application-versions-1" --- > ## 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. # Unqork Application Versions Unqork’s Application Versioning lets Creators save, label, and manage different iterations of their application. In other words, Unqork application versions give you structured control over application changes and updates, making it easier to manage releases, maintain compliance, and scale governance across multiple teams. ## How Application Versions Work? When Creators create a new application version, Unqork captures the full application state (modules, workflows, and configurations). You can manage these application versions using the Promotions and Versions page. This page includes the following tabs: - **Promotion History**: Use this tab to promote application versions to another environment level and view your promotion history. - **Set Default Version**: Use this tab to adjust the default application version. The default version of an application is the version that displays if no context is provided in the application URL. This is also the version of the application that will be used if another application sets the default as a dependency. This tab is useful when an issue occurs in your current default application version, and you need to return to the previous one. ## Best Practices: Naming Application Versions It’s important to understand the concept of major, minor, and patch versions before exploring the best practices for naming application versions: - **Major:** A major version includes architectural changes, new significant functionality, or a substantial update to an application. - **Minor**: A minor version includes small updates that help to improve application performance, all while maintaining backward compatibility. - **Patch:** A patch version includes bug fixes or other small fixes to improve the performance of an existing version. Below are some best practices for numbering application versions in Unqork: 1. We recommend using the automated numbering populated by selecting a major, minor, or patch update type. This uses the Semantic Versioning Principle of `Major.Minor.Patch` format in the **Version Number** field. For example, setting a **Version Number** for a Major release to `1.0.0`, as shown below. ![Interface for publishing a version with fields for version number and update type.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Major_Publish_Version_01.jpg?sv=2026-02-06&spr=https&st=2026-11-08T10%3A18%3A19Z&se=2026-11-08T11%3A18%3A19Z&sr=c&sp=r&sig=zbT8NK6gL3jflE1wCoVASKJRvM%2BhgdKKOYOWiA3X2GA%3D) 1. Keep version names consistent according to conventions set up by your team. ## Application Versioning Boundaries When Creators create an application version in Unqork, it includes the following application elements: - Application Modules (logic, schema, workflows, rules, validations) - Application Pages/Layouts (UI components) - Application Settings (navigation, metadata, app-level configurations) - Workflow Configurations Certain elements are not included at the time of application version creation. These elements sit outside versioning and are not tied to a specific application version: - **Data Collections:** The data stored in the environment is not captured with application versions; only the structure and logic are captured. - **Managed Assets:** Files in Managed Assets, like PDFs, Images, or CSS, are not captured with application versions. - **Environment Level Configurations**: Application integrations, RBAC policies, and SSO settings are not captured with application versions. - **Role Permissions:** Access permissions within the application applied to modules or components are included. - **External Services/**APIs**:** In application versioning, only references are stored; external services and APIs are not part of the version. Versioning boundaries ensure a clear separation of state between Staging, UAT, and Production. A version created in Staging does not automatically display in UAT or Production; it needs to be promoted. Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. Schema is a declarative language that defines the structure, content, and constraints of the data. The UI (user interface) is a device's end-user interaction and communication point. It can include display screens, keyboards, and mouse. It is also how a user interacts with your application. Cascading Style Sheets (CSS) is a style sheet language used for presenting how a HTML or XML document looks to end-users. RBAC (Role-Based Access Control) is a method to control system access for authorized users. The role in RBAC refers to the levels of access employees have to a network. Single Sign-On is an authentication scheme that enables users to use one set of login credentials across multiple services. APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services. The Staging environment is the first level of application building in Unqork. Use it to build, test, and style your applications. 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.