Official Content

An application life cycle reaches several "milestones" that are important to people working on (or with) it. The application entering the Test phase, Quality assurance or Production are just a few examples of these milestones. It is important, in the development process, to keep track of these milestones and save the application state for several reasons. They let you answer questions like:

  • What is in Production?
  • What is installed in Customer X?
  • What changes where made between the Test phase and Production?

In GeneXus these milestones are called Frozen Versions. They are read-only photos of an application at a given time. In Software Configuration Management the term "label" is also used to identify a frozen version.

There can be as many frozen versions as are needed in a Knowledge Base.

The purpose of frozen versions is to reflect important milestones (deployment, installation in Customer X, etc.) in an application's life cycle. A version in GeneXus is a read-only copy of an application. It's like a printed photo, which can be observed and/or analyzed but not modified.

To create a new Frozen Version, open the Knowledge Base Versions tool window, right-click on the first node of the tree (it has the same name as your Knowledge Base) and select "Freeze". Fill the New Frozen Version dialog and press Enter. The time it takes to create a frozen version is proportional to the size of your application.

KB Versions Freeze 1
Fig 1. Freezing a version (creating a new Frozen Version)

The action of creating a new Frozen Version is called "Freezing" a version.

The above guidelines tell you how to create a new version from what is known as the development versions. You cannot create a frozen version from another frozen version.

Frozen Versions can be used to :

  • Analyze (not modify) objects, properties, environments, etc.
  • As a source or target of a Database Impact Analysis Report
  • To create the database
  • To regenerate all programs

Import Backup

When an Import is performed over a Knowledge Version, if the Automatic Backup property is set to True, a special Frozen Version is created to backup the current Development Version. This new Frozen Version will have only one action available to execute: Revert. By executing this action, the active Development Version will be changed to the Import Frozen Version status or other Development Version status.


Versions with “pending changes” (that is, with objects that were changed since the last Impact Database was run) cannot be frozen. If you attempt to execute the freeze action, the following message appears: “Changes have been made since the last Build of Environment '.Net/Java Environment'. You must execute Build All before freezing.”

Last update: November 2023 | © GeneXus. All rights reserved. GeneXus Powered by Globant