---
schema_version: "1"
id: 5b5f8583932c7564fce510a0a803869c104640bd9109e494d81646dc890c00aa
title: MobileSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_mobilesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_mobilesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: df7756748b2b60a89c0d3cb153b51d02b98bd4e5972aa8d3e5a11c794969ae41
description: Represents an organization’s mobile settings. This type extends the Metadata metadata type and inherits its fullName field.
---
# MobileSettings

Represents an organization’s mobile settings. This type extends the Metadata metadata type and inherits its fullName field.

In the package manifest, all organization settings metadata types are accessed using the Settings name. See [Settings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_settings.htm "Represents the organization settings related to a feature. For example, your password policies, session settings and network access controls are all available in the SecuritySettings component type.") for details.

![Note](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png)

#### Note

[MobileSettings](#meta_mobilesettings "Represents an organization’s mobile settings. This type extends the Metadata metadata type and inherits its fullName field.") is no longer available in API versions 25.0 and 26.0.

## Declarative Metadata File Suffix and Directory Location

[MobileSettings](#meta_mobilesettings "Represents an organization’s mobile settings. This type extends the Metadata metadata type and inherits its fullName field.") values are stored in a single file named Mobile.settings in the settings directory. The .settings files are different from other named components because there’s only one settings file for each settings component.

## Version

Mobile settings are available in API version 27.0 and later.

## Fields

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d676436e121">Field</th>

              <th class="featureTableHeader vertical-align-top " id="d676436e124">Field Type</th>

              <th class="featureTableHeader vertical-align-top " id="d676436e127">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">chatterMobile</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type"><a class="xref" href="#ChatterMobileSettings">ChatterMobileSettings</a></td>

              <td class="entry" headers="d676436e127" data-title="Description">
                <span class="ph" id="chatterSettings_descr"><a name="chatterSettings_descr"><!-- --></a>The settings for
                  devices running Chatter mobile.</span> Removed
                in API version 46.0.
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">dashboardMobile</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type"><a class="xref" href="#DashboardMobileSettings">DashboardMobileSettings</a></td>

              <td class="entry" headers="d676436e127" data-title="Description"><span class="ph" id="dashboardSettings_descr"><a name="dashboardSettings_descr"><!-- --></a>Deprecated. The settings for
                  devices running the mobile dashboards app.</span></td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableImportContactFromDevice</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether users can import contacts
                from their mobile device (<samp class="codeph nolang">true</samp>) or not
                (<samp class="codeph nolang">false</samp>).<p class="p">Available in API version
                  47.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableLightningOnMobile</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether the org is enabled for the
                Salesforce mobile app. Available in API version
                47.0 only. Removed in API version 48.0. </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableNewSalesforceMobileAppForTablet</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether the org is enabled for the Salesforce mobile
                app tablet experience. Removed in API version 56.0.</td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableNewSalesforceMobileAppForTabletWideScreen</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether the org is enabled for the
                Salesforce mobile app widescreen tablet
                experience. Available in API version 52.0
                through 55.0. Removed in API version 56.0.
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableOfflineDraftsEnabled</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether users can create, edit, and
                delete records while offline in the Salesforce
                mobile app (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The
                default value is <samp class="codeph nolang">true</samp>. This option isn’t available
                if <span class="keyword parmname">enableS1OfflinePref</span> is
                set to <samp class="codeph nolang">false</samp>.<p class="p">Available in API version
                  47.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enablePopulateNameManuallyInToday</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether the user’s name is shown on
                the Today page in the Salesforce mobile app
                (<samp class="codeph nolang">true</samp>)
                or not (<samp class="codeph nolang">false</samp>). The default value is
                <samp class="codeph nolang">false</samp>.<p class="p">Available in API version
                  47.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableS1EncryptedStoragePref2</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether the Salesforce mobile web
                uses secure and persistent browser caching to
                improve performance (<samp class="codeph nolang">true</samp>) or not (<samp class="codeph nolang">false</samp>). The
                default value is <samp class="codeph nolang">true</samp>.<p class="p">Available in API version
                  47.0 and later.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">enableS1OfflinePref</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e127" data-title="Description">Indicates whether users can access records
                offline in the Salesforce mobile app (<samp class="codeph nolang">true</samp>) or not
                (<samp class="codeph nolang">false</samp>). This option is set to <samp class="codeph nolang">true</samp> the first
                time someone in your org installs one of the
                Salesforce downloadable apps.<p class="p">Available in API
                  version 47.0 and later. However, offline
                  access isn’t supported in all versions of
                  the downloadable mobile apps. Users must
                  have version 10.0 or later of the Salesforce
                  for Android app or the Salesforce for iOS
                  app. Offline access isn’t available for the
                  Salesforce mobile web.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e121" data-title="Field"><span class="keyword parmname">touchMobile</span></td>

              <td class="entry" headers="d676436e124" data-title="Field Type"><a class="xref" href="#TouchMobileSettings">TouchMobileSettings</a></td>

              <td class="entry" headers="d676436e127" data-title="Description"> The settings for devices running Salesforce
                Touch. Removed in API version 46.0.</td>

            </tr>

          </tbody>

        </table>

## ChatterMobileSettings

These fields are removed in API version 46.0. Represents your organization's Chatter Mobile settings.

<table class="featureTable sort_table" summary="">



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d676436e373">Field </th>

              <th class="featureTableHeader vertical-align-top " id="d676436e376">Field Type</th>

              <th class="featureTableHeader vertical-align-top " id="d676436e379">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">IPadAuthorized</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e379" data-title="Description">Indicates whether iPad devices are enabled for Chatter Mobile
                (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">IPhoneAuthorized</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e379" data-title="Description">Indicates whether iPhone devices are enabled for Chatter Mobile
                (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">androidAuthorized</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e379" data-title="Description">Indicates whether Android devices are enabled for Chatter Mobile
                (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">blackBerryAuthorized</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e379" data-title="Description">Indicates whether Blackberry devices are enabled for Chatter
                Mobile (<samp class="codeph java">true</samp>) or not (<samp class="codeph java">false</samp>).</td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">enableChatterMobile</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e379" data-title="Description">Indicates whether Chatter Mobile has been enabled for your
                organization (<samp class="codeph java">true</samp>) or not
                (<samp class="codeph java">false</samp>). <p class="p">Setting this
                  field to <samp class="codeph java">true</samp> enables you to
                  set all the other ChatterMobile settings. If you change this
                  setting from <samp class="codeph java">true</samp> to <samp class="codeph java">false</samp>, and also try to change any
                  of the other ChatterMobile settings, your deployment fails with
                  an error. </p>

              </td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">enablePushNotifications</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">boolean</td>

              <td class="entry" headers="d676436e379" data-title="Description">Indicates whether Chatter push notifications have been enabled
                for your organization (<samp class="codeph java">true</samp>) or
                not (<samp class="codeph java">false</samp>)</td>

            </tr>

            <tr>
              <td class="entry" headers="d676436e373" data-title="Field"><span class="keyword parmname">sessionTimeout</span></td>

              <td class="entry" headers="d676436e376" data-title="Field Type">MobileSessionTimeout (<a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_objects_intro.htm#enumeration_title">enumeration</a> of type string)</td>

              <td class="entry" headers="d676436e379" data-title="Description">
                <p class="p">The length of time after which users without activity are
                  prompted to log out or continue working. Valid values are:</p>

                <ul class="ul bulletList">
                  <li class="li"><samp class="codeph nolang">Never</samp></li>

                  <li class="li"><samp class="codeph nolang">OneMinute</samp></li>

                  <li class="li"><samp class="codeph nolang">FiveMinutes</samp></li>

                  <li class="li"><samp class="codeph nolang">TenMinutes</samp></li>

                  <li class="li"><samp class="codeph nolang">ThirtyMinutes</samp></li>

                </ul>

              </td>

            </tr>

          </tbody>

        </table>

## DashboardMobileSettings

These fields are deprecated. Represents your organization's Mobile Dashboards iPad app settings.

| Field | Field Type | Description |
| --- | --- | --- |
| enableDashboardIPadApp | boolean | Indicates whether Mobile Dashboards iPad app has been enabled for your organization (true) or not (false). |

## TouchMobileSettings

These fields are removed in API version 46.0. Salesforce Touch has been upgraded to the Salesforce mobile app.

| Field | Field Type | Description |
| --- | --- | --- |
| enableTouchBrowserIPad | boolean | Indicates whether your organization has the Salesforce Touch mobile browser app enabled (true) or not (false). |
| enableTouchAppIPad | boolean | Indicates whether your organization has the Salesforce Touch downloadable app enabled (true) or not (false) |

## Declarative Metadata Sample Definition

Here’s a sample mobile.settings metadata file.

<?xml version="1.0" encoding="UTF-8"?>
<MobileSettings xmlns="http://soap.sforce.com/2006/04/metadata">
    <enableImportContactFromDevice\>true</enableImportContactFromDevice\>
    <enableOfflineDraftsEnabled\>true</enableOfflineDraftsEnabled\>
    <enableS1EncryptedStoragePref2\>true</enableS1EncryptedStoragePref2\>
    <enableS1OfflinePref\>true</enableS1OfflinePref\>
</MobileSettings\>

## Wildcard Support in the Manifest File

The wildcard character \* (asterisk) in the package.xml manifest file doesn’t apply to metadata types for feature settings. The wildcard applies only when retrieving all settings, not for an individual setting. For details, see [Settings](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/meta_settings.htm). For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).