# Version Manager

### Prerequisites <a href="#bhc0ipy6l9e7" id="bhc0ipy6l9e7"></a>

* Your mobile application accounts must be connected to the [shelfy.io back office](https://shelfyconsole.io/).
* Your store information must be fully completed, including privacy policies and app integrity.
* Google Play: You must promote your first manual version before using shelfy.io version manager.

#### **Resources**

[Google Play Console ](https://play.google.com/console/developers)- <https://play.google.com/console/developers>

[Apple iOS ](https://developer.apple.com/)- <https://developer.apple.com/>

[App Store Connect ](https://appstoreconnect.apple.com/login)- <https://appstoreconnect.apple.com/login>

## **Version Manager**

Use shelfy.io Version Manager to do the following:

* Create new versions
* Promote versions to production
* Override an existing version
* Release a version
* Monitor current versions
* Review version history

### Benefits of using Version Manager&#x20;

* Inject data to your stores from one location, instead of having to do it once in the App Store, and then a second time in Google Play.
* Applications are built and managed with versions, and each version has its own content
* Add features from the Integration Panel in the shelfy.io back-office.
* Each version is given a unique number.
* In the shelfy.io back office add capabilities to your mobile apps such as the following:
  * Push notifications
  * Analytics
  * Ratings and reviews
  * Single sign on (SSO)
  * Other & more

Some integrations should be saved to the version to be distributed to production; the end users can use the new version content and features.

### Version release checklist

Make sure you have done the following in order to release your new version:

* [ ] Connected to Apple App Store and Google Play
* [ ] Uploaded stores assets
* [ ] Set launch screen
* [ ] Uploaded store content
* [ ] Added products to main shelf
* [ ] Created new app version

{% hint style="info" %}
You must complete the five steps in the Go Live Checklist before you can release your mobile app version.
{% endhint %}

{% hint style="success" %}
A red circle indicates the Go Live Checklist has not been completed.
{% endhint %}

Before you can create and release your new mobile app version, you must complete the five steps displayed in the image below.

![](https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FOGtUqre04XYldsHkLEiP%2F0?alt=media)

### Create the first version of your app

1. Click New Version to create the first versions of your app.<br>

   <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FICqkbSYXAIdPeTS9SsG4%2F1?alt=media" alt="" data-size="original">
2. Give the versions a meaningful name in order to better locate them and track their progress.<br>

   <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FB5FvtN2aLjzai0Oiaahz%2F2?alt=media" alt="" data-size="original">
3. Click Create new versions.<br>

   <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FmT8TQ7PGaZ9wZN6LA3oU%2F3?alt=media" alt="" data-size="original">\
   A pop-up message confirms the versions were successfully created, and the status of the two new stores changes to Open.<br>

   <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FlzvCBOWW5LMw9hILFkdq%2F4?alt=media" alt="" data-size="original">

#### Add features

{% hint style="info" %}
An Open status indicates you can add features from the Integration Panel to the versions. After adding the features, click Submit For Test.
{% endhint %}

1. After adding features from the Integration Panel, click Submit For Test. The In Progress notification is displayed.<br>

   <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FyqLglUqcD2gfm434ll9n%2F5?alt=media" alt="" data-size="original">
2. Click the reveal arrow to view the following:
   * **Integration panel:** The integrations that were saved to this current version.
   * **Store Listing:** The changes and updates that were saved to this current version.
   * **Core Version Updates:** The shelfy.io developer updates saved to this current version.<br>

     <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2Fg6jSDw3keAocQ84T5HYq%2F6?alt=media" alt="" data-size="original">
3. Review the versions' content.<br>

   <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FztCWF1zrvODBq2TvzVZ8%2F7?alt=media" alt="" data-size="original">

#### Publish your app

When your versions pass the testing mode, do the following:

* Google Play app: Click Review & Publish.
* App Store app: Click Submit For Review.<br>

  <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2Fo149UAYMxWh7qVEfAAWs%2F8?alt=media" alt="" data-size="original">\
  The In Review notification is displayed.<br>

  <img src="https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FexhEauM4LyS282V0Nrk2%2F9?alt=media" alt="" data-size="original">

{% hint style="info" %}

* When Google complete their review process, they publish your app for you on Google Play.
* When Apple complete their review process, you must click Publish to publish the app on the App Store.
  {% endhint %}

![](https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FcZEh5qjZpH9OxAR3YAGb%2F10?alt=media)

When your app is successfully published in both stores, the Live notification is displayed.

![](https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FR6G8sik054YxiuU1Rsfa%2F11?alt=media)

{% hint style="danger" %}
If your apps are rejected, you are notified by email from the app stores
{% endhint %}

If the apps are rejected, the Rejected notification is displayed.

![](https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2F0OvfnxSzNj0iZvTmPj9K%2F12?alt=media)

When both versions are live, The Go-Live Checklist status indiates the steps have been completed:

![](https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2F28k7L9EG4GKUzMoCoVPr%2F13?alt=media)

#### Conclusion

* After you succesfully publish your first version, you can  select which store  to upgrade with a newer version.
* Promote to both stores simultaneosuly, or promote to each store individually.

![](https://2992732956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuodSDNXHYMkfwgZ6AayC%2Fuploads%2FRwePmmvWZaf1vI8aqxhg%2F14?alt=media)
