1. Click either the “What’s new” link in the banner or the “New version available” link in the left-hand column of your app’s home page.
2. You can read information about the new version on top of the page that opens. At the bottom of the page, find the buttons: Upgrade current app and Create new app.
3. See descriptions of what the buttons do by hovering over them. If you click Upgradecurrent app, you overwrite your current app and all its assets, replacing it with an app based on the new version. This also deletes any customizations, including any new fields or object you’ve added to the dataflow or changes you’ve made to security settings and dashboard labels and colors. If you click Create new app, you create a second copy of your current app based on the new version. Decide which option suits your circumstances, and click the appropriate button.
4. WarningIf you’ve customized your app, click Create new app instead of Upgrade current app to make an app copy based on the new version. Thispreserves the current version and any customizations, which you can then manually copyinto the new version of the app.If you click Upgrade current app, you see a screen warning you that the upgrade option overwrites the current app and gets rid of any customizations you’ve made to it. If you’re OK with that, check the box and click Continue. If you’re not, click Back to return to the previous screen. Clicking Continue takes you to the configuration wizard. Skip ahead to step 6.
5. If you click Create new app, you’re taken to the configuration wizard. You don’t see a warning, since you’re not overwriting your current app, which is preserved with any customizations you’ve made to it.
6. The configuration wizard is preloaded with the settings you chose last time you used the wizard. You can either keep those settings or change them. Go through each page of the wizard.
7. Once you complete the wizard, Analytics shows a screen that indicates which assets are impacted by the upgrade. Review the screen to see how many datasets, dashboards, and lenses will be changed, deleted, or added by the upgrade. It also shows how changed assets will be modified—whether the change is to data or appearance. On the same screen, you have the option to download a file with code for changes made to the app. If you’ve customized the app, download and save the file so you can copy and paste customization code into the upgraded version.
8. Upgrade option only: If you’re upgrading your app, click Upgrade current app. Remember, this overwrites any customizations you’ve made. You can also click Back to go back into the configuration wizard and change your selections or click the X in the upper-right corner to cancel.
9. Create option only: If you’re creating a new app, name your app something different from the current version and click Create new app. This option saves your current app and all its customizations. You can also click Back to go back into the configuration wizard and change your selections or click the X in the upper-right corner to cancel.