---
schema_version: "1"
id: 14e51101b648efff9e56d9cc1d188809198d865b6fd84847b8d508c6f06e994d
title: OrgSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_orgsettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_orgsettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: a6323c2168d3a402156beb3c8b845074efe7179948ac785e230bafe6691d3ce9
description: Represents the settings for org-wide functionality that isn’t associated with any specific feature.This type extends the Metadata metadata type and inherits its fullName field.
---
# OrgSettings

Represents the settings for org-wide functionality that isn’t associated with any specific feature.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.

## File Suffix and Directory Location

An OrgSettings component file has the suffix .settings and is stored 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

OrgSettings components are available in API version 46.0 and later.

Before API version 51.0, the fields enableExtendedMailMerge and saveMailMergeDocsAsSalesforceDocs were found within OrgSettings components. In API version 51.0 and later, those fields are found within [MailMergeSettings](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_mailmergesettings.htm "Represents the settings for Extended Mail Merge functionality.").

## Fields

| Field Name | Field Type | Descriptions |
| --- | --- | --- |
|  |  |  |
| enableCustomerSuccessPortal | boolean | Indicates whether Customer Portal is enabled (true) or not (false). |
| enableManageSelfServiceUsers | boolean | Indicates whether mass management of self-service users is enabled through the Self-Service Portal (true) or not (false). |
| enableOrgFeedSentimentAnalysis | boolean | Indicates whether feed sentiment analysis is enabled for the org (true) or not (false). |

## Declarative Metadata Sample Definition

The following is an example of a OrgSettings component.

<?xml version="1.0" encoding="UTF-8"?>
<OrgSettings xmlns="http://soap.sforce.com/2006/04/metadata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <enableCustomerSuccessPortal\>false</enableCustomerSuccessPortal\>
    <enableMakeDeploymentsMandatory\>true</enableMakeDeploymentsMandatory\>
    <enableManageSelfServiceUsers\>false</enableManageSelfServiceUsers\>
    <enableOrgFeedSentimentAnalysis\>false</enableOrgFeedSentimentAnalysis\>
    <enableRADeploymentAttributeOnly\>true</enableRADeploymentAttributeOnly\>
</OrgSettings\>

## Example Package Manifest

The following is an example package manifest used to deploy or retrieve the org settings metadata for an organization:

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>Org</members\>
        <name\>Settings</name\>
    </types\>
    <version\>47.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).