---
schema_version: "1"
id: 8e59efaa984bad0e2d89bc216e26278a32c7f017b75ed0624e074363851d9cea
title: Picklist Values
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/uiapi/ui_api_responses_picklist_values.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_responses_picklist_values.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 9ec6121998d4482e557c2ad062187b84ed5d094769993d383775b7519503c9e0
description: The picklist values for a field, scoped to a record type. If a picklist is dependent, this response includes the values of its immediate controlling field and how they map to the picklist.
---
# Picklist Values

The picklist values for a field, scoped to a record type. If a picklist is dependent, this response includes the values of its immediate controlling field and how they map to the picklist.

<table class="featureTable sort_table" summary="">
          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d153428e28">Property Name</th>
              <th class="featureTableHeader vertical-align-top " id="d153428e30">Type</th>
              <th class="featureTableHeader vertical-align-top " id="d153428e32">Description</th>
              <th class="featureTableHeader vertical-align-top " id="d153428e34">Filter Group and Version</th>
              <th class="featureTableHeader vertical-align-top " id="d153428e36">Available Version</th>
            </tr>
          </thead>
          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d153428e28" data-title="Property Name"><samp class="codeph nolang">controllerValues</samp></td>
              <td class="entry" headers="d153428e30" data-title="Type">Map&lt;String, Integer&gt;</td>
              <td class="entry" headers="d153428e32" data-title="Description">
                <div class="p">If the picklist is dependent, this property is a map of its immediate controlling
                  field’s picklist values to their indexes. <ul class="ul bulletList">
                    <li class="li">If the controlling field is a picklist, the String is the picklist value and
                      the integer is the value’s index.</li>

                    <li class="li">If the controlling field is a checkbox, the values in the map are <samp class="codeph nolang">"false": 0</samp> and <samp class="codeph nolang">"true": 1</samp>.</li>

                  </ul>
                </div>

                <p class="p">If the picklist is independent, the map is empty.</p>

              </td>
              <td class="entry" headers="d153428e34" data-title="Filter Group and Version">Small, 41.0</td>
              <td class="entry" headers="d153428e36" data-title="Available Version">41.0</td>
            </tr>
            <tr>
              <td class="entry" headers="d153428e28" data-title="Property Name"><samp class="codeph nolang">defaultValue</samp></td>
              <td class="entry" headers="d153428e30" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_responses_picklist_value.htm#ui_api_responses_picklist_value" title="A single picklist value.">Picklist Value</a></td>
              <td class="entry" headers="d153428e32" data-title="Description">The default value for the picklist, or <samp class="codeph nolang">null</samp> if there
                isn't one.</td>
              <td class="entry" headers="d153428e34" data-title="Filter Group and Version">Small, 41.0</td>
              <td class="entry" headers="d153428e36" data-title="Available Version">41.0</td>
            </tr>
            <tr>
              <td class="entry" headers="d153428e28" data-title="Property Name"><samp class="codeph nolang">url</samp></td>
              <td class="entry" headers="d153428e30" data-title="Type">String</td>
              <td class="entry" headers="d153428e32" data-title="Description">A User Interface API resource that represents this payload.</td>
              <td class="entry" headers="d153428e34" data-title="Filter Group and Version">Small, 41.0</td>
              <td class="entry" headers="d153428e36" data-title="Available Version">41.0</td>
            </tr>
            <tr>
              <td class="entry" headers="d153428e28" data-title="Property Name"><samp class="codeph nolang">values</samp></td>
              <td class="entry" headers="d153428e30" data-title="Type">
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_responses_picklist_value.htm#ui_api_responses_picklist_value" title="A single picklist value.">Picklist Value</a>[]
              </td>
              <td class="entry" headers="d153428e32" data-title="Description">A list of values for this object, record type, field combination.</td>
              <td class="entry" headers="d153428e34" data-title="Filter Group and Version">Small, 41.0</td>
              <td class="entry" headers="d153428e36" data-title="Available Version">41.0</td>
            </tr>
          </tbody>
        </table>

#### See Also

- [Picklist Values Collection](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_responses_picklist_values_collection.htm "A collection of picklist values for all the picklists of a specified record type.")
- [Get Values for a Picklist Field](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_resources_picklist_values.htm "If a field’s dataType property is equal to Picklist or MultiPicklist, use this resource to get its values.")
- [Get Values for All Picklist Fields of a Record Type](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_resources_picklist_values_collection.htm "Use this resource to get the values for all the picklist fields of a specific record type. This resource is especially useful for getting dependent picklist values. For example, if an object has a tree of dependent picklists (Continents__c, Countries__c, Cities__c), use this resource to get all the values for each picklist in one request.")
- [Build UI for Picklists](https://developer.salesforce.com/docs/atlas.en-us.uiapi.meta/uiapi/ui_api_features_records_dependent_picklist.htm "User Interface API exposes properties and resources that make it easy for a client to build picklists and dependent picklists.")