---
schema_version: "1"
id: eb83677a8e9524514ca4c8e51f048933d88d6894a130129153cdced17bb873ce
title: LiveMessageSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_livemessagesettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_livemessagesettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3dfbc953cd9328397a3b89c3b425e48b2ba68b2eaac7fe61bc2a7fbce3939e0a
description: Represents an org’s LiveMessage settings.
---
# LiveMessageSettings

Represents an org’s LiveMessage settings.

## Version

LiveMessageSettings components are available in API version 42.0 and later.

## File Suffix and Directory Location

LiveMessageSettings values are stored in the LiveMessage.settings file in the settings folder. The .settings files are different from other named components because there is only one settings file for each settings component.

## Fields

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



          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d643100e76">Field Name</th>

              <th class="featureTableHeader  " id="d643100e79">Field Type</th>

              <th class="featureTableHeader  " id="d643100e82">Description</th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d643100e76" data-title="Field Name"><span class="keyword parmname">enableCheckCEUserPerm</span></td>

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

              <td class="entry" headers="d643100e82" data-title="Description">Gives access to ConversationEntry objects only to users with the Access
                Conversation Entries user permission enabled (true) or to all users (false) in an
                org.<p class="p">For orgs created before API version 50.0, the default value is <samp class="codeph nolang">false</samp>.</p>
                <p class="p">For orgs created on or after API
                  version 50.0, the default value is <samp class="codeph nolang">true</samp>.</p>
              </td>

            </tr>

            <tr>
              <td class="entry" headers="d643100e76" data-title="Field Name"><span class="keyword parmname">enableLiveMessage</span></td>

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

              <td class="entry" headers="d643100e82" data-title="Description">Turns LiveMessage on (<samp class="codeph java">true</samp>) or off (<samp class="codeph java">false</samp>) in an org. The default value is <samp class="codeph java">false</samp>.</td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following is an example of a liveMessageSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<LiveMessageSettings xmlns="http://soap.sforce.com/2006/04/metadata">
   <enableLiveMessage\>true</enableLiveMessage\>
</LiveMessageSettings\>

The following is an example package.xml that references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>LiveMessage</members\>
        <name\>Settings</name\>
    </types\>
    <version\>44.0</version\>
</Package\>

## 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).