Managing Versions
A version is a snapshot of your monetization configuration packaged for deployment across environments. Versions enable you to track changes, test configurations in non-production environments, and deploy proven setups to production with confidence.
Navigating to the Environments section will show you a list of all versions. If you have Brands enabled, select the relevant brand to see this screen.
In this section, you can see details for your latest deployment, recent changes that have been made, and which version is deployed to which environment.
Understanding the Versions Page
The versions cards is broken into three sections: Versions, Latest Deployment, and Change Summary
Versions
The Versions card helps you track and manage application versions.
When you have changes that can be bundled into a new version, this section will show a 'Create New Version' button, otherwise it will state 'Workspace Up-to-Date'.
Each version in your list will have a version number and a timestamp for when it was created.
If your workspace is up-to-date, your latest version will show a 'Latest' label.
Deployed versions display environment labels. For example, 'Preview' or 'Live'.
You can deploy any version by clicking the 'Deploy' drop down arrow and selecting the relevant environment from the list.
Latest Deployment
The Latest Deployment card details the most recent deployment made, including the version number and the environment it was deployed to. For example, Version 15, deployed to Live.
It also includes a timestamp of when the version was deployed, and who it was deployed by.
Change Summary
Any unpublished changes will be detailed in this section. Clicking 'View Changes' will take you to a detailed list of changes that have been made.
Add a New Version
Versions can be created in one of two ways: From the tick icon in the top-right (when not using brands), or from the Environments section.
Creating a New Version From The Tick Icon
If you're managing a single brand, click the tick icon in the top right corner of the app.
You'll see a Recent Changes card, detailing how many unpublished changes you have.
To bundle these changes into a new version, click 'Create New Version'.
This will take you to the Environment section. The version you just created will be at the top of the versions list, and labeled as 'Latest' and 'Preview'.
Latest means it is fully up-to-date with all changes to your environment.
Preview means it is the current live version for your Preview environment.
Creating a New Version From the Environments Section
When you're ready to create a new version, navigate to the Environments section from the left-hand navigation menu.
In the versions card, click 'Create New Version'.
The version you just created will be at the top of the versions list, and labeled as 'Latest' and 'Preview'.
Latest means it is fully up-to-date with all changes to your environment.
Preview means it is the current live version for your Preview environment.
Deploy a Version
To deploy a version to a different environment, navigate to Environments in the left-hand navigation menu and locate the version in the versions list.
Click the three dots to the right-hand side of the version, then select the relevant 'Deploy To' option.
A sheet will open detailing the version number, the environment being deployed to, and the delta between the version and the current environment. For example, what has been created and modified.
To complete this step, click 'Deploy to'. Otherwise, click 'Cancel'.
Rollback a Version
While MonetizationOS doesn't have an explicit rollback feature, it is simple to re-deploy an previous version at any time. To do this, navigate to Environments in the left-hand navigation menu and locate the version you wish to rollback to in the versions list.
Deploy this version following the instructions above.
Delete a Version
To delete a version, navigate to Environments in the left-hand navigation menu and locate the version you wish to delete to in the versions list.
Click the three dots to the right-hand side, then click 'Delete'.
Please note: You cannot delete a version that is currently deployed. If you wish to delete a version deployed to an environment, please deploy a different version, then follow the delete instructions.