---
schema_version: "1"
id: 98f975d2def1ee0c8638e7e49b4d68484fd0a238706588dd91c359171d8ddb36
title: Urge or Require Users to Update to the Latest Mobile Publisher App Version
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/branded_apps_app_settings.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.branded_apps_app_settings.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: cddf93a33febf588d15044c85cb9de580fd0d383d04c1ff3a9f1f265d3205f40
description: For publicly distributed Mobile Publisher for Experience Cloud apps, you can use the App Version Update settings in Experience Builder to configure a message that encourages or requires your app users to install updates. By updating their app, users can avoid any service disruptions.
products:
  - Experiences
  - Mobile App
  - Cross Cloud
release: "264"
---
# Urge or Require Users to Update to the Latest Mobile Publisher App Version

For publicly distributed Mobile Publisher for Experience Cloud apps, you can use the App Version Update settings in Experience Builder to configure a message that encourages or requires your app users to install updates. By updating their app, users can avoid any service disruptions.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: Lightning Experience</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Setup for Mobile Publisher available in: production only (not sandbox)</td></tr></tbody><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in Lightning Experience in: <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions</td></tr></tbody></table>

<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="d11465e87">User Permissions
              Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d11465e87 ">To create and modify a Mobile Publisher project:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11465e87 ">Manage mySalesforce Apps</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d11465e87 ">To create and modify a site:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d11465e87 ">Create and Set Up Experiences</td>

          </tr>
        </tbody>
      </table>

Only publicly distributed apps support the App Version Update settings in Experience Builder.

1. If you downloaded and installed the [Mobile Publisher App Update Lightning component](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3u00000QsTFbEAN), remove that component from your site and republish it so that your app users don’t get duplicate update prompts.
2. Make sure that you push at least iOS App Version 10.0 to the App Store, or Android App Version 10.1 to Google Play.
3. In Experience Builder, navigate to **Settings** | **Mobile Publisher** | **App Settings**.
    
    ![App Settings Tab](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/branded_apps_exp_cloud/images/app_settings_patch.png)
4. Select **Show App Version Update Message**.
5. Enter the links to your app in the App Store Link and Google Play Link fields. These fields are required when you enable Show App Version Update Message.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/images/icon_note.png)
    
    Note If you use the [ExperienceBundle metadata type](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_experiencebundle.htm) to deploy your Experience Cloud site, the properties in the mobilePublisherAppUpdateConfig container correspond to the settings for how your app handles version updates. If the enableAppUpdate property is set to `true`, you’re required to enter values for the App Store Link and Google Play Link fields in Experience Builder. To turn off this validation, set the enableAppUpdate property in the ExperienceBundle metadata type to `false`.
    
    ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/images/icon_important.png)
    
    Important
    
    The Mobile Publisher app uses two different methods to notify users of available updates, depending on the user's installed app version.
    
    - **Native App Update (App Versions 11.0 and newer)**: Modern app versions use the native update functionality from the Apple App Store and Google Play Store. The app checks the store directly for a new version. The **Show App Version Update Message** setting enables this check.
    - **Web View App Update (App Versions older than 11.0)**: Older app versions use a WebView pop-up message to prompt users to update. This legacy method is controlled by the **Minimum App Version** fields.
6. (Legacy) Enter your app’s iOS and Android Minimum App Versions.
    
    These settings force an update prompt for users on app versions older than 11.0. If a user's app version is lower than the value you specify here, they see a message prompting them to update. For any user on app version 11.0 or newer, these fields are ignored.
7. To urge or require users to update, configure these settings:
    
    - Confirm that **Select App Version Update Message** is enabled, to prompt the update check.
        
        For modern apps (11.0+), this setting triggers the native update prompt if a newer version is available in the App Store or Play Store.
        
        For legacy apps (<11.0), this setting displays the WebView update message if the user's version is below the specified **Minimum App Version**.
    - Select **Require users to update** to make the update prompt mandatory. Users can't dismiss the message and must update the app to continue.
        
        ![Message requiring users to update](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/branded_apps_exp_cloud/images/app_settings_banner1.png)
        
        If you only want to encourage users to update, leave the Require users to update option deselected. Your app users see a dismissable message that encourages them to update, but allows them to update at a later time.
        
        ![Message encouraging users to update](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/branded_apps_exp_cloud/images/app_settings_banner2.png)
8. Publish your site.

App users who run a version of your app that’s earlier than 10.0 on iOS and 10.1 on Android get an update prompt the next time they launch the app. If the app user taps **Update Later**, the update prompt is shown each time the user navigates to another page in the site.

After you change the Minimum App Version in your app’s settings, users have a 15-day grace period to update their apps. If you deselect the **Require users to update** option in your Mobile Publisher settings in Experience Builder, your app users have **Update Later** or **Update** buttons available in their app update prompt for 15 days. After 15 days, the update prompt shows only the **Update** button. If you keep the **Require users to update** option selected, the update prompt shows only the **Update** button.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-branded_apps_exp_cloud-264-0-0-production-enus/cf85363c-215e-4784-bb6a-c5c83c4e7140/images/icon_note.png)

Note In Winter ’24, the use of enhanced domains is being enforced for all orgs. To help you test, Salesforce deployed Enhanced Domains in sandbox and non-production orgs with the Winter ’23 release. Salesforce deploys this feature in all orgs with Spring ’23 and Summer ’23. You can opt out of the auto-deployment of Enhanced Domains before Spring ’23. For more information, refer to the [Enhanced Domains Timeline](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_enhanced_timeline.htm&type=5&language=en_US).