New Picklist Field Value Not Visible on Record Due to Field Dependency in Salesforce

When a picklist field is controlled by a dependency, adding a new value to the picklist does not automatically include it in the dependency. You must update the Field Dependency matrix to include the new value under the appropriate controlling field values. Follow the steps below to check and update the field dependency.

Check and Update the Field Dependency

In Salesforce Classic

1. Navigate to:
   1. Standard Object: Setup | Customize | (object name) | Fields | Custom Fields & Relationships | Field Dependencies
   2. Custom Object: Setup | Create | Objects | (object name) | Fields | Custom Fields & Relationships | Field Dependencies
2. Locate the affected picklist field in the Field Dependencies list.
3. Click Edit on the relevant dependency.
4. In the dependency matrix, select the new picklist value in the Dependent Picklist column.
5. Click Include Value to add it for the relevant Controlling Field values.
6. Click Save.

In Lightning Experience

1. Navigate to Setup | Object Manager | (object name) | Fields & Relationships | Field Dependencies.
2. Locate the affected picklist field.
3. Click Edit on the relevant dependency.
4. In the dependency matrix, select the new picklist value in the Dependent Picklist column.
5. Click Include Value to add it for the relevant Controlling Field values.
6. Click Save.

After completing these steps, the new picklist value is available on records when the appropriate controlling field value is selected.

Key Terms

• Field Dependency: A feature in Salesforce that filters the values available in a dependent picklist based on the value selected in a controlling picklist or checkbox field.
• Controlling Field: The field whose value determines which values appear in the dependent picklist.
• Dependent Picklist: The picklist whose available values are filtered based on the controlling field.
• Include Value: The action in the dependency matrix editor that makes a specific picklist value available when a given controlling value is selected.