Salesforce Dictionary - Free Salesforce GlossarySalesforce Dictionary
Full Master Picklist entry
How-to guide

Manage Master Picklist values

Managing picklist values involves master-level changes and per-record-type configuration. The steps below cover both halves.

By Dipojjal Chakrabarti · Founder & Editor, Salesforce DictionaryLast updated May 19, 2026

Managing picklist values involves master-level changes and per-record-type configuration. The steps below cover both halves.

  1. Open the field

    Object Manager > Object > Fields and Relationships > Picklist field > Edit.

  2. Add or edit master values

    In the Values section, add new values, deactivate retired ones, or reorder. Changes to the master propagate to all referencing record types.

  3. Mark Restricted (recommended)

    Check Strictly enforce picklist values. Prevents user-typed values outside the master.

  4. Save the master changes

    The master is updated. Record types do not automatically expose new values; the next step is needed.

  5. Configure per record type

    For each record type on the object, edit the picklist value selection. Enable the new values on relevant record types; leave unrelated record types unchanged.

  6. Set default value per record type

    Optionally set a different default value for each record type. The default is per record type, not at the master.

  7. Test from a sample user

    Use Login As to confirm the new values appear on record creation and the default behaves as expected.

Key options
Add valueremember

Add a new value to the master.

Deactivate valueremember

Remove from picklist going forward; preserve historical records.

Restricted picklistremember

Prevent user-typed values outside the master.

Sort orderremember

Control display order of values in dropdowns.

Global Value Set referenceremember

Use shared values across multiple fields.

Gotchas
  • Add to master before enabling on record types. Skipping the master step makes the value invisible to users.
  • Deleting values from the master replaces them on records. Deactivation is safer; deletion is irreversible at the record level.
  • API name changes break integrations. Relabel rather than rename when possible.
  • Unrestricted picklists allow user-typed values. Defeats the data quality purpose; mark Restricted in production.
  • Default value is per record type, not at the master. Configure separately for each record type.

See the full Master Picklist entry

Master Picklist includes the definition, worked example, deep dive, related terms, and a quiz.