Craft 3 Documentation


You can create taxonomies for your entries, users, and assets using Categories.

Category Groups #

Before you can create categories, you must create Category Groups to contain them. Each Category Group lets you define the following:

To create a new category group, go to Settings → Categories and click the “New Category Group” button.

After you create at least one category group, you will be able to create categories for that group.

Category Field Layout #

Each Category Groups can have its own Field Layout, which allows you to customize the data that is associated with each category in the group. By default, every category will have a Title filed (the category name).

You can also add additional fields using all of the available field types in Craft. If a field doesn’t yet exist, you must first create it via Settings → Fields. The new field will then be available to assign to the Field Layout of your Category Group.

Creating and Editing Categories #

If you have at least one category group, there will be a “Categories” tab in the primary Control Panel navigation. Clicking on it will take you to the category index. From there you can choose a category group from the sidebar, and add/reorder/delete categories within it:

Category Index

Double-clicking on a category will bring up a modal that lets you edit its name, slug, and any fields you’ve assigned to the group.

Category Edit Modal

When you create a category, you have the following options:

You can only nest categories up to the level specified in the Max Level field Category Group settings. If no level is specified then the nesting level is unlimited.

Assigning Categories #

To assign categories to things (entries, assets, users, etc.), you must first create a Categories field.

Each Categories field is connected to a single category group. Whatever you attach the field to will be able to create relations to any of the categories within that group.