App Versioning

Developer Hub will help you manage your application over time, allowing you to look back on historical changes and even restore back to previous versions.

Note:  Refer to our App Manifest documentation to manage app versions effectively.

Let's go over the basics of Version Logs. A new manifest version is automatically generated when you save an update to your application, such as adding a new UI location or updating the OAuth settings. When a new version is created, it is available as an update for private apps.

Note: Developer Hub handles changes made to the application’s manifest. It cannot detect any modifications the developer makes to the application code, referred to as the App URL in Hosting. Changes to your application code will take effect immediately and be accessible to your users.

Browse and Restore

Let’s take a closer look at how versions can be browsed.

To view and create versions of an app via the Developer Hub interface, login to your Contentstack account and follow the steps given below:

1. Navigate to the app you created. In the left navigation panel, click the Developer Hub icon to navigate to it. 
2. You will be directed to the app dashboard where you will see all the apps created so far. Select an app to get started. For example, click Sample to view the app information.
3. By default, the app's Basic Information page will open. You will see a Version drop-down with the latest version selected.
   
4. Click the Version dropdown, to see a list of all the versions created for the app.

   You can preview a specific version of your app by clicking the preferred version from the dropdown.
   

   

   Details such as version number, creator name, date, and the version creation date and time is displayed for individual versions in the dropdown.

5. To restore your app to this selected version and set it as the latest version, click the Yes, Restore button.
   
6. A confirmation pop-up appears, click Yes, Restore to confirm the changes.

Version Logs

To view complete details of all the versions, follow the steps below:

1. In the left navigation of the app's dashboard page, click the Version Logs tab.
   
2. You will see the details and list of all the versions created for the app in a tabular format. The different columns with relative information are as follows:
   1. Version: Displays the version number.
   2. Created By: Displays the name of the user who created the version.
   3. Created At: Displays the date and time of creation.
   4. Actions: On clicking the three dots, you will see one option:
      • View: Displays all details of a version. You can go back and check the details of a particular version.
      • 
3. Clicking View redirects you to the Basic Information page to preview that specific version. Now you can browse the application manifest for that particular version and restore it as latest if required.