---
schema_version: "1"
id: 132b457822dcc4cd491874c9d1b47275414e9103a14d29fd8997799e85e844ea
title: PicklistSettings
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_picklistsettings.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_picklistsettings.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: d86d97efd5b72541cb677e6bc305375fad27215327fd1a8d28d2604fa905373b
description: Represents an org’s picklist settings. These settings control the behavior of a picklist. This type extends the Metadata metadata type and inherits its fullName field.
---
# PicklistSettings

Represents an org’s picklist settings. These settings control the behavior of a picklist. 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

PicklistSettings values are stored in a single file named Picklist.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

Picklist settings are available in API version 47.0 and later.

## Fields

| Field Name | Field Type | Description |
| --- | --- | --- |
| isPicklistApiNameEditDisabled | boolean | While true, users, including admins with Customize Application permission, can’t change the API name of a picklist field. Formulas reference a picklist’s API name so that the formula continues to work even if the displayed name value changes. Prevent changes to the API name to protect the references to fields in formulas or during integrations, such as during a data import. The default is false. |

## Declarative Metadata Sample Definition

The following is a sample picklist.settings metadata file.

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

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

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