Version Control

Version Control in the Developer Hub lets you identify different versions of an application. This feature allows you to access essential information about the app such as the app creator's name, and the date and time when the app was created/updated, inside the Version drop-down on the Basic Information page.

When a user changes or updates app information in any tab such as UI Locations, Webhooks, App Manifest, or OAuth, a new version gets created. In short, each app update results in a new version.

This feature helps you keep track of all the changes ever made to an app. You can simply navigate to the versions and view the changes. With the Version Control tab in Developer Hub, you can view details of all the versions created for the apps.

Let’s see how to navigate to the Version Control tab.

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. Click the Developer Hub icon on the left navigation panel.
2. You will be navigated to the apps dashboard where you will see all apps created so far.

   Select the desired app to view its Version.

3. By default, the app's Basic Information page will open. You will see the Version drop-down with the latest version selected.
4. When you click the Version dropdown, all the versions created for the app so far will be visible.

   You can view or make the changes by selecting a particular version from the dropdown.

   Details such as version number, creator name, date and time the version was created will be displayed for individual versions in the dropdown.

5. If you want to restore your app to this opened version, click the Restore This Version button.

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

1. On the app's page, click the Version Control tab from the left navigation panel.
2. On the top left corner, you will see the Versions tab.
3. You will see the list of all the versions created for the app in a tabular format. You will be presented with different columns, with relative information as follows:
   1. Version: Displays the version number.
   2. Release Tag: Displays the release tag number created for the version.
   3. Created By: Displays the name of the creator.
   4. Created At: Displays the date and time of creation.
   5. Actions: On clicking the three dots, you will see two options:
      1. View: To view the version details.
      2. Create Release Tag: To create a new release tag.
4. In the Actions column, for each version, there is a more option icon. Click it.

   You will be presented with two options: View and Create Release Tag.

5. When you click on View, you'll be directed to the Basic Information page with options as discussed above.
6. From here, you can restore the app to this version by clicking the Restore This Version button. Clicking Restore This Version will update the app with the latest changes and save the changes into a new version.
7. If you click the Create Release Tag option, the New Release Tag modal will open. To learn more about Release Tag, refer to this guide.