6.6. Setting Up a Taxonomy

Last updated on

11 January 2024

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

Site prerequisites

The Recipe content type must exist. See Section 6.1, “Adding a Content Type”.

Steps

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 Section 2.7, “Concept: User Interface, Configuration, and Content translation” for an explanation.)
Click Add vocabulary, and fill in the values below.
Field name Explanation Example value
Name
The name of the vocabulary
Ingredients
Description
A brief note about the vocabulary
(Leave blank)
Click Save. You will be taken to the Ingredients page, which shows a list of all the terms in this vocabulary.
Click Add term. Enter "Butter" in the Name field. Click Save.
You will receive a confirmation about the term you created. Add more terms. For example, "Eggs" and "Milk".
In the Manage administrative menu, navigate to Structure > Content Types (admin/structure/types). Click Manage fields for your Recipe content type.
Click Add field, and enter values from the table below. Click Save and continue.
Field name Explanation Value
Label
The title to give the field
Ingredients
Choose a type of field
Select the field type
Reference
Choose an option below:
Type of content to reference
Taxonomy term

Field name	Explanation	Example value
Name	The name of the vocabulary	Ingredients
Description	A brief note about the vocabulary	(Leave blank)

Field name	Explanation	Value
Label	The title to give the field	Ingredients
Choose a type of field	Select the field type	Reference
Choose an option below:	Type of content to reference	Taxonomy term

On the following configuration screen, enter the values from the table below. Click Save settings.

Field name	Explanation	Value
Help text	Help shown to users creating content	Enter ingredients that site visitors might want to search for
Type of item to reference	The type of entity that is referenced by the field	Taxonomy term
Allowed number of values	The number of values a user can enter	Unlimited
Reference type > Reference method	Select the method used to choose allowed values	Default
Reference type > Vocabulary	Select the vocabulary to choose allowed values from	Ingredients
Reference type > Create referenced entities if they don’t already exist	Whether new ingredient terms can be created from the content editing form	Checked

reference type field settings

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.

Videos

Setting up a Taxonomy

Attributions

Written and edited by Bob Snodgrass, and Jojy Alphonso at Red Crackle.

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: structure-taxonomy-setup.asciidoc