---
schema_version: "1"
id: 050cca54a682281abfa46b3338e18f142308a74d8d1e02ca24ba781d5fe189ad
title: Upgrade the Event Monitoring Analytics App
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/analytics/264-0-0/bi_app_event_monitor_wave_upgrade.md
canonical_url: https://help.salesforce.com/s/articleView?id=analytics.bi_app_event_monitor_wave_upgrade.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 600179496f2ac5fb06e8d700e083b0ca7753e22e242a30fdf76216eaa644ccf8
description: Take advantage of the latest Event Monitoring Analytics App features by upgrading your app every time we release a new version.
products:
  - CRM Analytics
  - Cross Cloud
release: "264"
---
# Upgrade the Event Monitoring Analytics App

Take advantage of the latest Event Monitoring Analytics App features by upgrading your app every time we release a new version.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d175496e25">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d175496e25 ">To create and manage Event Monitoring Analytics apps:</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d175496e25 ">Access Event Monitoring Analytics Templates and Apps</td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d175496e25 ">&nbsp;</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d175496e25 ">Manage CRM Analytics Templated Apps</td>
          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d175496e25 ">&nbsp;</td>
            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d175496e25 ">Edit CRM Analytics Dataflows</td>
          </tr>
        </tbody>
      </table>

The banner at the top of your app home page tells you that we released a new version. It also provides a link to more information about the release. There’s also a link inviting you to start the upgrade process in the left column of the home page, just below the app name.

Here’s how to upgrade your app.

1. Click either the **What’s new** link in the banner or the **New version available** link in the left 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 **Upgrade current app**, you overwrite your current app and all its assets, replacing it with an app based on the new version. Upgrading also deletes any customizations, including new fields or objects that you added to the dataflow or changes that you 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
4. ![Warning](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-analytics-bi-264-0-0-production-enus/ec791473-f5b4-4f64-a656-9104f455d966/images/icon_warning.png)
    
    Warning
    
    If you customized your app, click **Create new app** to make an app copy based on the new version. Creating an app preserves the current version and any customizations, which you can then manually copy into 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 made. If you’re OK with overwriting customizations, 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 because you’re not overwriting your current app, which is preserved with any customizations you 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.
    
    If you are overwriting the current app, the retention window must be at least four days.
7. After you complete the wizard, CRM Analytics shows a screen that indicates which assets the upgrade impacted. To see how many datasets, dashboards, and lenses get changed, deleted, or added by the upgrade, review the screen. It also shows how changed assets get 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 customized the app, download and save the file so that you can copy and paste the customization code into the upgraded version.
8. Upgrade option only: If you’re upgrading your app, click **Upgrade current app**. Remember, this setting 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 an 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.

If the link below the app name says Reset app, you’re using the latest version and an upgrade is unnecessary.