HomeDev GuideRecipesAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityOptimizely AcademySubmit a ticketLog In
Dev Guide

Categories

Classify content in Optimizely CMS. Create, delete, and manage categories to enhance filtering, search, and navigation features for your website visitors.

📘

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.

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.

    Screenshot of the Categories tab in Settings showing the Create Category button and existing categories list
  2. Fill in the following fields.

    Screenshot of the Create Category dialog showing fields for Name, Display name, Visible checkbox, and Selectable checkbox
    • Name – Specify a name used in code when building category-based functionality.
    • Display name – Enter a name visible in edit view when a user selects categories. Language-encode this field to support multiple locales.
    • Visible – Select to display the category in the Select Categories dialog box in edit view.
    • Selectable – Select to make this category selectable in the Select Categories dialog box in edit view.
  3. Select Create Subcategory to add a subcategory.

    Screenshot showing the Create Subcategory option in the category menu to add a child category
  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

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.

❗️

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

  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.

    Screenshot of the Category panel in page edit view where editors can click to select and assign categories to content
  2. Select the categories for the page and click OK.

    Screenshot of the Select Categories dialog showing a hierarchical tree of categories with checkboxes for selection

    The categories display in the Category field.