Set up a project
Purple Experience Builder

Software Version

7min

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.

Switching the Purple Experience version for web

To change the release branch for your Web Experience, navigate to your App in Purple Manager. Via the dots Menu switch to "Experience":

Via the dots Menu switch to "Experience"


And chose the proper branch in the version dropdown:

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.

Handling different versions of the Purple Experience

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

Switching the Purple Experience version for Apps

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).

Upgrade App Experience Version


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.

Returning to the previous Purple Experience/ Dynamic version

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).

App Overview in Purple Manager
App Overview in Purple Manager


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).

Change history of Dynamic Content in Purple Manager
Change history of Dynamic Content in Purple Manager


Choose the previously downloaded file in your local download folder (1) and press "Open" (2).

Dynamic Content download zip file
Dynamic Content download zip file


If the upload was successful, you will get a confirmation message in Purple Manager.

Confirmation message in Purple Manager
Confirmation message in Purple Manager


And your newest upload will appear in the Change history.

Change history of Dynamic Content in Purple Manager
Change history of Dynamic Content in Purple Manager