---
schema_version: "1"
id: f3a86534fbef53f1f4c78aacef48c3a6b9f38245d2d72a752a22b16bb5dbb275
title: LiveAgentSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_liveagentsettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_liveagentsettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: e96f352fa297c1b5564b2df9f2712aa9447f6c2cbe16cb9500fe6475831c55fb
description: Represents an organization’s Chat settings, such as whether Chat is enabled. This type extends the Metadata metadata type and inherits its fullName field.
---
# LiveAgentSettings

Represents an organization’s Chat settings, such as whether Chat is enabled. This type extends the Metadata metadata type and inherits its fullName field.

## File Suffix and Directory Location

LiveAgentSettings values are stored in the LiveAgent.settings file in the settings directory. The .settings files are different from other named components because there’s only one settings file for each settings component.

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.

## Version

LiveAgentSettings is available in API version 28.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| enableChatFindOrCreateEnable | boolean | Indicates whether the findOrCreate method of the Chat API is enabled for agents (true) or not (false). Available in API version 53.0 and later. |
| enableLiveAgent | boolean | Indicates whether Chat is enabled (true) or not (false). |
| enableQuickTextEnabled | boolean | Indicates whether Quick Text is enabled (true) or not (false). |

## Declarative Metadata Sample Definition

This is a sample Chat settings file.

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

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

#### See Also

- [_Service Cloud Chat Developer Guide:_ findOrCreate](https://developer.salesforce.com/docs/atlas.en-us.264.0.live_agent_dev.meta/live_agent_dev/live_agent_creating_records.htm "Service Cloud Chat Developer Guide:
    findOrCreate - HTML (New Window)")