# Create value sets

A <u>**value set**</u> is a list of <u>values</u> that should be translated during data processing. This could be a common code set (e.g., LOINC, SNOMED) or a custom code set your organization uses. 

A <u>**translation set**</u> is made of two <u>**value sets**</u>. You must create a value set for each code set you’re translating to and from between systems. [Learn more about translation sets](/how-to-use-redox/create-translation-sets-and-links).

## Prerequisites

- All environment users can view value sets. However, a user must be assigned to an <u>**engineer**</u> or a <u>**support**</u> role to create or edit value sets. [Learn about user roles](/basics/managing-access-for-your-redox-organization/what-are-user-roles).
- To delete a value set, you must first remove it from any active translation sets. 
- _Limitations_: 
  - A value se<u>t</u> can contain up to <u>7,500 values</u>.
  - A value set can’t be promoted independently. When a translation set is promoted, its value sets are promoted with it. 
- _Versioning_: Editing a <u>value set</u> creates a new version but doesn’t automatically update an associated translation set. You must update the value mappings in the translation set to advance the version. 

## View value sets

1. Log in to the Redox dashboard.
2. From the side nav menu, click the **Operations** drop-down.
3. The Operations options expand. Click the **Translations** option.


![The Translations option is a sub-option under the Operations tab. ](https://images.ctfassets.net/cl3wt5ehhnlv/4hfApZYQQnrTeoG7cWz4FG/164e170258e977016c061e93d9f02f5d/side-nav-operations-translations.png)

*Translations in the side nav*


4. By default, the <u>Value sets</u> tab opens. Review any existing value sets or create a new one. 


![A table shows existing value sets in the environment.  ](https://images.ctfassets.net/cl3wt5ehhnlv/3QGtlnZ14hbN5zdgRIVnoh/44c8218a915b60baa125a9a49c8eb1a9/translations-value-sets-tab.png)

*Value sets tab*



## Create a value set

1. Follow the steps to view value sets.
2. Click the **New** button.
3. The create form opens. In the <u>Name</u> field, enter a **human-friendly name** for the value set. 
This name appears on the <u>Value Sets</u> tab and in the translation set create form when selecting value sets.
4. Build your value set in the table. Type a **value** in a row. To add another value, press **Enter** on your keyboard or click the **Add row** button. 

> **Importing values (workaround)**
>
> If you want to directly import values from a CSV file (more than 25 values) to create a value set, use the import option for creating a translation set instead. [Learn how to create a translation set](/how-to-use-redox/create-translation-sets-and-links).




> **Value set limits**
>
> A value set may contain up to 7,500 values, while an individual value may contain up to 500 characters.


5. Repeat for each value.  
6. If needed, click in the **row** to edit a value or the **delete** icon to delete it.
7. Click the **Create** button.


![A user adds values to create a value set in the wizard. ](https://images.ctfassets.net/cl3wt5ehhnlv/4mMeNPpACQ5OwRug4qRyT5/dc7c60b2504e47f256977bc990fbcc52/value-set-create.gif)

*Create a value set*


8. The value set’s <u>Details</u> page opens. View recent activity, including who last updated the set, and what translation set(s) it’s applied to. 
9. If needed, repeat these steps to create another value set to map to. Remember, you must have two value sets to create one translation set.

## Edit a value set

1. Follow the steps to view value sets.
2. Find the value set you want to edit and click anywhere in its **row.** 
3. The <u>Details</u> page opens. Under the <u>Value set details</u> section, click the **Edit** button.
4. The edit form opens so you can add, edit, or delete any values. 
5. Click the **Save** button.


![A user edits a value, adds a new value, and delete a value in a set.](https://images.ctfassets.net/cl3wt5ehhnlv/4jP7zDWMsfI5XLmXDQMig6/4b146e2abdc0de59adad3e995eaa02ac/value-set-edit.gif)

*Edit a value set*


6. This creates a new version of the value set. To apply it, you must edit the associated **translation set**. Editing the translation set automatically pulls the new value set version forward. 
   1. Navigate to the associated translation set. Click the **Edit** button. 
   2. In the translation set, update the **value mappings** based on the edits you made to the value set. When you’re finished, click the **Save** button. 

## Delete a value set

> **Can’t delete an active value set**
>
> You’ll get an error if you try to delete a value set that’s used in an active translation set (or the <u>Delete</u> button will be disabled on its <u>Details</u> page). 
>
> First delete any mapped translations, then remove it from the translation set to delete the value set. 

1. Follow the steps to view value sets.
2. Find the value set you want to delete. Click the t**hree-dots** icon, then the **Delete** option.
Alternatively, click anywhere in its **row** to open the <u>Details</u> page to review any details prior to deleting. Click the **Delete** button. 
3. A confirmation modal opens. Click the **Delete** button to continue.


![A user deletes an existing value set. ](https://images.ctfassets.net/cl3wt5ehhnlv/7uAVC4SRtDmROP2OuUZOgb/64e39394bc361709170500144d5dca36/value-set-delete.gif)

*Delete a value set*



> **Platform API endpoints**
>
> This article describes how to manage values and value sets in the <u>**Redox dashboard**</u>. To manage value sets via <u>**API**</u>, use these <u>**Redox Platform API**</u> endpoints instead:
>
> - [Create value set](https://docs.redoxengine.com/permalink/a8620c02-0d80-5b21-82d1-149f0703017a-create-value-set)
> - [Update value set](https://docs.redoxengine.com/permalink/214a4ae1-7872-5dab-b1ac-edcbe13fc10c-update-value-set)
> - [Delete value set](https://docs.redoxengine.com/permalink/12a79e5a-fa0e-5705-b3a6-75ddeb5d9393-delete-value-set)
> - [Create value](https://docs.redoxengine.com/permalink/94eb3ee0-6743-5803-a2b2-bcd67cf79a21-create-value) 
> - [Update value](https://docs.redoxengine.com/permalink/f36fc937-fc61-54ea-9d7b-306d1f1a10a6-update-value)
> - [Delete value](https://docs.redoxengine.com/permalink/ee271b5a-8b36-5a6f-8d14-d3ee5ea58ec0-delete-value)
