Trying to migrate a global picklist using a 37.0 package.xml, but if I change the version to 38.0, I get an error that GlobalPicklist is not supported in API version 38.0.

Anyone notice it?

1 Answer 1


Yes, GlobalPicklist has been replaced by GlobalValueSet. This is outlined in the relevant documentation and was mentioned in the release notes.

Streamlined Metadata API for Picklists

We bring you elegance and efficiency with a reimagined Metadata API for picklists, with no wasted elements to clutter your API calls. The new structure clearly differentiates between global picklist value sets, local custom picklists, and standard picklists, making it super-easy to track your fields and values. This feature is available in both Lightning Experience and Salesforce Classic.

If you're using API v37.0, you can still use the existing elements for defining picklists and their values. If you're using API v38.0, your brain is about to get a break because defining all types of picklists makes more sense.

Here's a high-level comparison:

| Metadata Type in API Version 37.0  | Metadata Type in API Version 38.0 |
| Picklist                           | StandardValueSet, ValueSet        |
| GlobalPicklist                     | GlobalValueSet                    |
| GlobalPicklistValue, PicklistValue | CustomValue                       |
| GlobalPicklistTranslation          | StandardValueSetTranslation,      |
|                                    | GlobalValueSetTranslation         |

For type and field descriptions and sample definitions, see the Metadata API Developer Guide.

  • 2
    @AdrianLarson Hmm. I need to read the release notes more often. They've gotten far more amusing than they were previously.
    – sfdcfox
    Feb 16, 2017 at 2:37
  • 1
    They're definitely worth a read these days. Seems there are a few worthy nuggets each release.
    – Adrian Larson
    Feb 16, 2017 at 3:18

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.