Skip to main content

Value Set Renaming: Handling Existing Names

How to Change the Name of a Value Set Entry When the Name Is Already in Use

This article explains how to change the Name of a value set entry in a situation where the desired name is already assigned to another value.

Example Scenario (shown in screenshots)

Initial state:

  • Label: Asscher, Name: Asscher

  • Label: Baguette, Name: Baguette

Target state:

  • Label: Asscher, Name: Baguette

  • Label: Baguette, Name: BGT


This screenshot shows the initial set of values available in the value set.


Step 1

Change the Label of the value Asscher to a temporary label.
In this example, the label is changed to AsscherOld.

⚠️ Important: This value must remain active.

This screenshot shows the label change from Asscher to AsscherOld.


Step 2

Change the Name of the value Baguette to a new name, BGT.

Note: You must change the Name of the value whose new name is not currently used by another value.

This screenshot shows the name change from Baguette to BGT.

After this change, do not be alarmed if the value disappears from its original position in the list.
In reality, the updated value is simply moved to the end of the list.


Step 3

You will now see that the value with the Name Baguette appears in the list of inactive values.

  • Change its Label to Asscher

  • Activate this value

This screenshot shows the value in the inactive list

This screenshot shows the value being activated and the label changed to Asscher


Step 4

Deactivate the value with the Label AsscherOld using the dropdown menu on the right.

A modal window will appear:

  1. Select the "Replace value on records with" option

  2. From the list, choose Asscher — this is the new value with the correct updated Name

This screenshot shows the modal window used to complete this step.


Result

The value set now contains:

  • Label: Asscher, Name: Baguette

  • Label: Baguette, Name: BGT

The name conflict is resolved correctly without data loss or invalid references.

Did this answer your question?