---
schema_version: "1"
id: 8c602fb74752948c75382b53e2a1e2f795d6c75d5424c23c37fb8b64184f0cab
title: StandardValueSet
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_standardvalueset.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_standardvalueset.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 12b66ddc9de21f491301ea85185c8d9066b534dbd29b68f9cb9d6d07f1822eba
description: Represents the set of values in a standard picklist field. This type extends the Metadata metadata type and inherits its fullName field.
---
# StandardValueSet

Represents the set of values in a standard picklist field. This type extends the Metadata metadata type and inherits its fullName field.

## File Suffix and Directory Location

StandardValueSet components have the suffix .standardValueSet and are stored in the standardValueSets folder.

## Version

StandardValueSet components are available in API version 38.0 and later.

## Fields

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



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

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

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

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d879295e84" data-title="Field Name"><span class="keyword parmname" id="groupingStringEnum"><a name="groupingStringEnum"><!-- --></a>groupingStringEnum</span></td>

              <td class="entry" headers="d879295e87" data-title="Field Type">string</td>

              <td class="entry" headers="d879295e90" data-title="Description">Groups picklist and enumerated values. For example, for the picklist values of
                the <span class="keyword parmname">Status</span> field on the Service Appointment object, <samp class="codeph nolang">Done</samp> and <samp class="codeph nolang">Finished</samp> can both have a grouping string of <samp class="codeph nolang">Completed</samp>. Available in API version 41.0 and later.</td>

            </tr>

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

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

              <td class="entry" headers="d879295e90" data-title="Description">Required. Indicates whether a global value set is sorted in alphabetical order.
                By default, this value is <samp class="codeph nolang">false</samp>.</td>

            </tr>

            <tr>
              <td class="entry" headers="d879295e84" data-title="Field Name"><span class="keyword parmname" id="field_standardValue"><a name="field_standardValue"><!-- --></a>standardValue</span></td>

              <td class="entry" headers="d879295e87" data-title="Field Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_customvalue.htm#standardvalue">StandardValue[]</a></td>

              <td class="entry" headers="d879295e90" data-title="Description">Defines each value in a standard picklist’s value set. The
                <span class="keyword parmname">groupingString</span> value is available in API version 38.0 and
                later. <p class="p">When you deploy a StandardValueSet, this array must contain at least one
                  picklist value. Otherwise, you receive an error.</p>
                <div class="box message info">
                  <div class="inner">
                    <div class="bd">
                      <div class="media">
                        <img class="img mtm" src="https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note.png" alt="Note">
                        <div class="mediaBd">
                          <h4 class="mbs">Note</h4>
                          <p>When setting
                            <span class="keyword parmname">standardValue</span> on Record Types, including person account
                            record types, new picklist values loaded into your organization through the
                            Metadata API don’t display in the picklist UI by default. For users to see the new
                            values, go to the Record Types list for the object containing the picklist field,
                            click <strong class="ph uicontrol">Edit</strong>, and add the new value to the Selected Fields
                            list.
                          </p>
                        </div>
                      </div>
                    </div>
                  </div>
                </div>
              </td>

            </tr>

          </tbody>

        </table>

## Declarative Metadata Sample Definition

The following example shows a StandardValueSet component that’s defined as the Stage standard picklist on a customized opportunity object.

<?xml version="1.0" encoding="UTF-8"?>
<StandardValueSet xmlns="http://soap.sforce.com/2006/04/metadata">
    <fullName>OpportunityStage</fullName> <!-- Enum name -->
    <standardValue>
       <fullName>Closed Abandoned</fullName>
    </standardValue>
    <standardValue>
       <fullName>Closed Won</fullName>
    </standardValue>
    <standardValue>
       <fullName>Closed Lost</fullName>
    </standardValue>
</StandardValueSet>

<CustomObject>
    <fullName>Opportunity</fullName>
    <fields>
       <fullName>StageName</fullName> <!-- field name -->
       <label>Stage</label>
       <type>Picklist</type>
    </fields>
    <label>ObjectWithValueSet</label>
    <pluralLabel>ObjectWithValueSet</pluralLabel>
    <sharingModel>ReadWrite</sharingModel>
</CustomObject>

    

For a list of standard value set names for standard picklists, see [StandardValueSet Names and Standard Picklist Fields](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/standardvalueset_names.htm "In API version 38.0 and later, standard picklists are represented by the StandardValueSet type. In previous versions, standard picklists are represented by the CustomField type. This table lists the names of standard picklists as standard value sets and their corresponding field names.").

## Wildcard Support in the Manifest File

This metadata type doesn’t support the wildcard character \* (asterisk) in the package.xml manifest file. 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).