# Setting Up a Taxonomy

## Goal

Create an Ingredients vocabulary and add it to the Recipe content type as
a field that can contain an unlimited number of values and that allows adding
new terms to the vocabulary.
## Prerequisite knowledge

* [Concept: Content Entities and Fields](/link/691)
* [Concept: Taxonomy](/link/724)
* [Adding Basic Fields to a Content Type](/link/722)
## Site prerequisites

The Recipe content type must exist. See [Adding a Content Type](/link/720).
## Steps

1. In the _Manage_ administrative menu, navigate to _Structure_ > _Taxonomy_
    (_admin/structure/taxonomy_). You will see the _Tags_ vocabulary that was
    created with the core Standard installation profile. (Note that the name and
    description of this vocabulary are shown in English on this page; see
    [Concept: User Interface, Configuration, and Content translation](/link/695) for an explanation.)
    <img src="https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-taxonomy-page.png" alt="taxonomy list page" width="100%" />
1. Click _Add vocabulary_, and fill in the values below.
    <table>
      <thead>
        <tr>
          <th>Field name</th>
          <th>Explanation</th>
          <th>Example value</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>Name</td>
          <td>The name of the vocabulary</td>
          <td>Ingredients</td>
        </tr>
        <tr>
          <td>Description</td>
          <td>A brief note about the vocabulary</td>
          <td>(Leave blank)</td>
        </tr>
      </tbody>
    </table>

    <img src="https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-add-vocabulary.png" alt="taxonomy add Ingredients" width="100%" />

1. Click _Save_. You will be taken to the Ingredients page, which shows a list
    of all the terms in this vocabulary.
    <img src="https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-vocabulary-overview.png" alt="Ingredients taxonomy term listing" width="100%" />
1. Click _Add term_. Enter "Butter" in the _Name_ field. Click _Save_.
    <img src="https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-add-term.png" alt="Add term page" width="100%" />
1. You will receive a confirmation about the term you created. Add more
    terms. For example, "Eggs" and "Milk".
1. In the _Manage_ administrative menu, navigate to _Structure_ > _Content Types_
    (_admin/structure/types_). Click _Manage fields_ for your Recipe content type.
1. Click _Create a new field_. The _Add field_ page appears. Choose the _Reference_ field type from the _Choose a field type_ options. Click _Continue_. The _Add field_ page appears with a form to configure the field.
    ![Add Ingredients field to Content type Recipe](https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-add-field.png)
1. Enter values from the table below. Click _Continue_.
    <table>
      <thead>
        <tr>
          <th>Field name</th>
          <th>Explanation</th>
          <th>Value</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>Label</td>
          <td>The title to give the field</td>
          <td>Ingredients</td>
        </tr>
        <tr>
          <td>Choose an option below:</td>
          <td>Type of content to reference</td>
          <td>Taxonomy term</td>
        </tr>
      </tbody>
    </table>

    ![Settings for Ingredients field](https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-add-field-label.png)

1. On the following configuration screen, enter the values from the table below. Click _Save settings_.
    <table>
      <thead>
        <tr>
          <th>Field name</th>
          <th>Explanation</th>
          <th>Value</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>Help text</td>
          <td>Help shown to users creating content</td>
          <td>Enter ingredients that site visitors might want to search for</td>
        </tr>
        <tr>
          <td>Type of item to reference</td>
          <td>The type of entity that is referenced by the field</td>
          <td>Taxonomy term</td>
        </tr>
        <tr>
          <td>Allowed number of values</td>
          <td>The number of values a user can enter</td>
          <td>Unlimited</td>
        </tr>
        <tr>
          <td>Reference type > Reference method</td>
          <td>Select the method used to choose allowed values</td>
          <td>Default</td>
        </tr>
        <tr>
          <td>Reference type > Vocabulary</td>
          <td>Select the vocabulary to choose allowed values from</td>
          <td>Ingredients</td>
        </tr>
        <tr>
          <td>Reference type > Create referenced entities if they don't already exist</td>
          <td>Whether new ingredient terms can be created from the content editing form</td>
          <td>Checked</td>
        </tr>
      </tbody>
    </table>

    <img src="https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-field-settings-2.png" alt="reference type field settings" width="100%" />

1. Click _Save settings_. You will be taken back to the _Manage Fields_ page. A
    message will be displayed saying that the configuration for Ingredients is
    complete.
    <img src="https://docs.cocobook.com/uploads/images/gallery/2026-10/structure-taxonomy-setup-finished.png" alt="Manage fields page for Recipe content type" width="100%" />

## Videos

[Setting up a Taxonomy](https://www.youtube.com/watch?v=EbsXffnjsjc)