---
title: Categories
slug: cms-13/docs/categories
docTags: 
createdAt: 2026-07-30T20:22:09.287Z
---

:::hint{type="info"}
**Note**
This topic is for CMS administrators and developers with administrative access rights.
:::

In Optimizely Content Management System (CMS), a category classifies content. For example, use categories to build filtering features for search and navigation. A category is also known as a taxonomy, which is a system of classification. Categories let editors apply a consistent classification scheme across pages, blocks, and media.

A category is a built-in property in CMS. Apply categories to content. Build the filtering and navigation functionality to display the results on your website. Do not confuse content categories with Commerce Connect categories. For information about catalog entries, go to [Work with catalog entries](docId\:ML4mC_-jC3MldFQV9qu7N).

## Create a category

Categories group related content so editors can apply a consistent classification scheme across pages, blocks, and media. Create a category whenever the site needs a new tag for filtering, search, or navigation features.

To create a top-level category:

1. Go to **Settings** > **Categories** and click **Create Category**. A window opens.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/krD1agpRTFhWhTuGwiGC0_79a5e36181f3db29cfaccd1b4626a5f2f3f4bef715fae2fb3c8c424a1ed827f6-image.png)

2. Fill in the following fields.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ySK0hZQmYMKdswgUNjKui_01d4a68097654a9b389b14bcb615c7307516b565ecd271cdc34855c234a32a0d-image.png)

:::Paragraph{listStyleType="disc" indent="2"}
**Name** – Specify a name used in code when building category-based functionality.
:::

:::Paragraph{listStyleType="disc" indent="2"}
**Display name** – Enter a name visible in edit view when a user selects categories. Language-encode this field to support multiple locales.
:::

:::Paragraph{listStyleType="disc" indent="2"}
**Visible** – Select to display the category in the **Select Categories** dialog box in edit view.
:::

:::Paragraph{listStyleType="disc" indent="2"}
**Selectable** – Select to make this category selectable in the **Select Categories** dialog box in edit view.
:::

3. Select **Create Subcategory** to add a subcategory.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/nNbEYNnS75tnxWolbz6GY_a749e2a8e85156e28a00aafbd299102a91d56c1e9f7306236dd6bef2bb56ad23-image.png)

4. Add the subcategory in the same way as the top-level category.

![Screenshot of the Create Subcategory form showing the same name, display name, visible, and selectable fields as the top-level category form](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/7UJgo1RwaIqDGTDXEC60e-20260722-195705.png)

Drag a category to reorder it in the list. This order controls how categories display in the **Select Categories** dialog box.

## Delete or change a category

Removing or editing a category retires obsolete classifications and keeps the taxonomy aligned with the current site structure. Coordinate with developers first, because front-end filters and navigation components might depend on the category.

:::hint{type="danger"}
**Warning**
Depending on how a category is used on your website, changing or deleting a category may cause things to stop working. Check with your developer before changing or deleting a category.
:::

1. Go to **Settings** > **Categories**.
2. Select **More** (...) > **Delete**. A confirmation window opens.

![Screenshot of the delete confirmation dialog asking the user to confirm deletion of the selected category](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/gFL6XRw0xvv55E2xuyIjn-20260722-195705.png)

3. Click **Delete** to confirm.

## Add categories to a page

Assigning categories to a page tags it for the filtering, search, and navigation features that surface related content to visitors. Apply categories during editing so the page joins the correct taxonomy. Only categories marked as **Visible** and **Selectable** display in the **Category** panel.

1. Open a page for editing and click **Category**.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/tL-2X0SFMr826iQlIpI8A_7ee2ea2bb2e867f45e6d2d4909f15222697436cc069226f00bef8d842c37ae93-image.png)

2. Select the categories for the page and click **OK**.

![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Qym25eFuOK_fn-rSoNzB6_f924eb27bd3995877b1692b51d105d00c7684e36ebad409852eae125be9b547f-image.png)

The categories display in the **Category** field.