Skip to main content

Picklist Values

Picklist values are properties of Picklist fields that can be edited by the Subscriber.

When the ISV changes a Picklist value of any managed custom field, such as:

  • Adding, renaming, or deleting a Picklist value
  • Activating or deactivating a Picklist value

...these changes will not be delivered to subscribers through a package upgrade.

Picklist Values in Salesforce

What’s Updated by ZuppIO​

ZuppIO updates Picklist Fields or the corresponding Global Value Sets only if they exist in both the Source and Target org.

Update Logic​

  • New Picklist values in the Source org that are missing in the Target org are added to the end of the existing values in the same order as they appear in the Source.
  • Existing Picklist values in the Target org remain unchanged (order and properties are not modified).
  • The Default attribute of a Picklist value is updated only if:
    • The old and new Default values exist in both Source and Target orgs.
    • The subscriber has not reassigned the Default value manually.
  • If a Picklist field references a Global Value Set, the corresponding Global Value Set is updated.

Record Types​

  • Selected Picklist values per Record Type are updated only if they exist and are active in both the Source and Target orgs.

What’s Ignored by ZuppIO​

ZuppIO does not update:

  • Picklist values in the Global Value Sets or Picklist Fields that do not exist in the Target org.
  • Record Types that do not exist in the Target org.

How to Deploy Picklist Values in ZuppIO​

To deploy Picklist values, follow these steps:

  1. Open a Job.
  2. Press the New Step button.
  3. Name your step.
  4. Select Picklist Values as the step type.
  5. Choose what you want to deploy:
    • "All picklists" → Deploy all managed Custom Fields of Picklist type.
    • "Select picklists" → Select specific managed Custom Fields of Picklist type from the available list.
  6. Save your changes.
  7. Select your new step.
  8. Select at least one Target org.
  9. Choose an execution mode:
    • Press Validation → Runs the job in "checkonly" mode (validates but does not apply changes).
    • Press Execute → Applies changes to the Target org(s) without validation.