After July 2021, the 2.3.x release line will no longer receive quality updates, or user guide updates. PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in September 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x to help maintain PCI compliance.

Creating Categories

The information on this page is intended for Adobe Commerce 2.3 customers who are on an extended support contract. The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.

The category structure of your catalog is like an upside-down tree, with the root at the top. Each section of the tree can be expanded and collapsed. Any disabled or hidden categories are grayed out. The first level of categories below the root typically appear as options in the main menu. You can create as many additional subcategories as needed, according to the maximum menu depth that is set in the configuration. Categories can be dragged and dropped to other locations in the tree. The category ID number appears in parentheses after the category name at the top of the page.

For a website with multiple stores, you can create a different root category for each store that defines the set of categories that is used for the top navigation.

Category Tree

Step 1: Create a category

  1. On the Admin sidebar, go to Catalog > Categories.

  2. Set Store View to determine where the new category is to be available.

  3. In the category tree, select the parent category of the new category.

    The parent is one level above the new category.

    If you’re starting from the beginning without any data, there might be only two categories in the list: Default Category, which is the root, and an Example Category.

  4. Click Add Subcategory.

Step 2: Complete the basic information

  1. If you want the category to be immediately available in the store, set Enable Category to Yes.

  2. To include the category in the top navigation, set Include in Menu to Yes.

  3. Enter the Category Name.

    Basic Information

  4. Click Save and continue.

Step 3: Complete the category content

  1. Expand the Content section.

    Category Content

  2. To display a Category Image at the top of the page, you can either upload your own image or use an image that already exists in your Media Storage.

    • To upload your own image, click Upload and choose the image that you want to represent the category.

    • To use images from your Media Storage, click Select from Gallery and select the image you want to represent the category.

    Inside the Media Gallery, you may also leverage the Adobe Stock Integration to find an appropriate image by clicking Search Adobe Stock.

  3. For Description, enter the text that you want to appear on the category landing page.

    You can format the text as needed. For more information, refer to Using the Editor.

  4. To include a content block on the category landing page, choose the CMS Block that you want to appear.

  5. Click Save and continue.

Step 4: Complete the display settings

  1. Expand the Display Settings section.

  2. Set Display Mode to one of the following:

    • Products Only
    • Static Block Only
    • Static Block and Products
  3. If you want the category page to include the Filter by Attribute section of layered navigation, set Anchor to Yes.

  4. To change the Available Product Listing Sort By options, do the following:

    • Deselect the Use All checkbox.

    • Select one or more of the available values to be available for customers to sort the list. By default, all available values are included. For example, the values might include:

      • Position
      • Product Name
      • Price
  5. To set the default sort order for the category, choose the Default Product Listing Sort By value.

  6. To change the default layered navigation price step setting, do the following:

    • Deselect the Use Config Settings checkbox.

    • Enter the value to be used as an incremental price step for layered navigation.

  7. Click Save and continue.

    Display Settings

Step 5: Complete the search engine optimization settings

  1. Expand the Search Engine Optimization Settings section.

  2. Complete the following meta data for the category:

    • Meta Title
    • Meta Keywords
    • Meta Description

    Search Engine Optimization

  3. Click Save and continue.

Step 6: Choose the products in category

  1. Expand the Products in Category section and use one of the following methods to add products to the category.

  2. Use the filters as needed to find the products.

    To display all records that are not yet included in the category, set the record chooser in the first column to No and click Search.

  3. In the first column, select the checkbox for each product to include in the category.

    Products In Category

  4. Click Save and continue.

Step 7: Set the category permissions

  1. Expand the Category Permissions section.

  2. For a multi-site installation, choose the Website where the category permissions apply.

  3. Choose the Customer Group where the category permissions apply.

    • If needed, you can choose a Shared Catalog instead.
  4. Set the following permissions as needed:

    • Browsing Category
    • Display Product Prices
    • Add to Cart
  5. To add another permission rule, click New Permission and repeat the process.

    Category Permissions

Step 8: Complete the design settings

  1. Expand the Design section.

  2. Set the design settings as needed:

    • To apply the parent category design settings to this category, set Use Parent Category Settings to Yes.

    • To change the design of the category pages, choose the Theme that you want to apply.

    • To change the column layout of the category pages, choose the Layout that you want to apply.

    • To enter custom code, enter valid XML code in the Layout Update XML box.

    • To use the same design for product pages, set Apply Design to Products to Yes.


  3. To schedule the design update for a specific time period, do the following:

    • Expand the Schedule Design Update section.

    • Use the calendar () to choose the Schedule Update From and To dates.

      Scheduled Design Update

  4. When complete, click Save.