Software Version
The Purple team regularly provides new versions of the Purple Experience that come with additional functionality. Depending on your project setup, those changes are deployed to your staging and live environments.
The version that is applied to your Purple Apps can be changed from the Purple Experience Builder. To switch to an explicit version for web, you need to go to Purple Manager.
To change the release branch for your Web Experience, navigate to your App in Purple Manager. Via the dots Menu switch to "Experience":
And chose the proper branch in the version dropdown:
After upgrading your Purple Experience, you may verify the proper version in your environment with opening its preview the devtools of your browser.
For any website we provide an environment under web.purplemanager.com. Please refer to your Purple Managers settings for your respective URL. Please note: By default those Environments are tied to the current (master-)release. When you want to test against any other branch, refer to this URL-Schema https://(<branch>.)web.(<env>.)purplemanager.com/<brand> where
branch: develop, release-x-y-z, feature branches if deployed. If it's not set, it will go to master
env: staging or dev, if not set, prod
brand: refer to the basic settings of your App in Purple Manager
You can check your current version and new versions available in the Burger Menu (1) in the top-right corner of your Experience Builder, when clicking on 'Upgrade Purple Experience Version' (2).
By moving the toggle (3) you have the option to get only the final Experience Versions displayed, or also Snapshots and unstable Versions. Your currently used Purple Experience version is displayed (4) on this page as well.
You have a list of all available Purple Experience versions on which you can upgrade below e.g. 2.5.0 (5) and you can select the desired Version from the list.
By clicking on 'Select a version' (6) you confirm your selection.
Please refer to the release notes in the Product Updates for details on the different versions.
We recommend upgrading the Purple Experience version separately on staging and not mixing it with any other changes you might want to make. You can do the necessary configurations afterwards on staging and publish the full package to prod as a final step.
To release your changes, you need to go to your App in Purple Manager > Overview > Three dot menu > Dynamic, and perform the 'Copy to Release' action.
If the Purple Experience version was upgraded for testing reasons, it is sometimes necessary to downgrade the Purple Experience to the previous version once the testing is completed. This is done via dynamic resources in the Purple Manager:
Navigate to your App in Purple Manager. Via the dots Menu (1) and click on 'Dynamic' (2).
In the Change history, go to the latest content version that was uploaded before your Experience upgrade and click on the download icon (1). In the Dynamic Preview content row click on the upload icon (2).
Choose the previously downloaded file in your local download folder (1) and press "Open" (2).
If the upload was successful, you will get a confirmation message in Purple Manager.
And your newest upload will appear in the Change history.
