2.2 Configure enumerations

#Overview

When we create product entries for our e-commerce, we want to be able to select values - such as product size or color - from a dropdown menu. This makes sense for our project because we want to be able to only publish products in certain colors & sizes. Making this a dropdown in our content creation screen ensures that only the values we predefine will be used for those product characteristics.

In Hygraph, you do this by adding a dropdown menu to your model. This dropdown gets the list of values from an enumeration that you need to configure before you create the dropdown field.

An enumeration is a predefined set of values that represents a list of possible options. We can use enumerations to group values within a type and then use them when we add a dropdown field.

We will be using enumerations for the components that we are going to create in our next lesson. Let's configure them.

#Configure enumerations

Adding enumerations is very simple.

Adding enumerations

We always add them in the same way:

1. In the Schema editor, we click on +Add next to Enumerations.
2. We then type in a Display name, which is the name that we will see in the Schema.
3. We also add an API ID, which we can use later to access the enumeration through the API Playground.
4. Next, we add enumeration values by typing them in the Values field and then clicking on +Add to list. We will need to do this for each value.
5. To save our enumeration, we simply click Add enumeration.

For this tutorial, we will add 4 enumerations: separate sizes for shoes and clothes, and separate colors for wearables and decor.

Use the following information to add them:

Clothes size

Clothes size enumeration

Shoes size

Shoes size enumeration

Wearable items color

Wearable items color enumeration

Decor items color

Decor items color enumeration

After adding your Enumerations the left sidebar should look like this:

Your enumerations listed in the schema