> For the complete documentation index, see [llms.txt](https://docs.themeware.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themeware.design/additional-features/extensions/listing-subcategories.md).

# Listing subcategories

The "Subcategories in Listing" feature familiar from our themes for Shopware 5 is also available in ThemeWare® for Shopware 6.

You can activate this theme extension via the theme configuration. Like all theme configurations, this configuration is also global. This means that the subcategory navigation will then appear on all CMS pages of the type "Listing page".

Starting with ThemeWare® 3.2.4, you can activate/deactivate this global navigation via a custom field in selected categories.

In addition, the extension can also be displayed on shop pages in the future; the test phase for this will start soon.

<figure><img src="/files/Jk3gVK7WvW1WojdYThUO" alt=""><figcaption><p>ThemeWare® "Listing subcategories"</p></figcaption></figure>

The texts and images shown were taken from the category management ("Catalogues" => "Categories") of Shopware. The "**Name**" and the "**Image**" (= Display image) of the corresponding categories are displayed. The image is not mandatory.

{% hint style="info" %}
**Note**: As the name suggests, the ThemeWare® extension "Listing subcategories" only works on CMS pages of the type "Listing page". In addition, subcategories in Shopware 6 are only displayed for the main category.
{% endhint %}

{% hint style="success" %}
**Guide**: You can find a step-by-step guide in the ThemeWare® Wiki: [Showing subcategories in the listing](https://knowledge.themeware.design/knowledge-base/tutorials/categories/subcategories-in-listing)
{% endhint %}

***

## Configuration

### **Theme configuration**

1. Go to the tab "**Extensions**"
2. Expand the block "**Listing subcategories (on listing pages)**"
3. Enable the configuration "**Show 'Listing subcategories' (CMS listing pages)**"
4. Optional: Use the further configuration options
5. Save your changes after editing

{% hint style="success" %}
**Tip**: In the Pro Edition, a corresponding CMS extension is also available. This allows you to freely position a dedicated CMS block in your layouts and configure it individually: [Listing subcategories](/additional-features/cms-extensions/cms-elements/listing-page/listing-subcategories.md)
{% endhint %}

### **Content**

1. Switch via the main navigation to the "**Category managment**" (1) (2) ("Catalogues" => "Categories")
2. Choose the category you want to edit (3)
3. To the right of the category list, the corresponding category now opens in the category editor (4)
4. You are in the tab "**General**"
5. In the block "**General**" you can edit the category name (**Name**).
6. Scroll to the block "**Menu settings**"
7. Here you can edit the category image (**Display image**)
8. Save your changes

<figure><img src="/files/w84WkMKYHL6LodAEmPU7" alt=""><figcaption><p>Shopware 6 "Category managment"</p></figcaption></figure>

***

## Display options

Here you have the following options for listing and shop pages:

* don't show
* show
* show (via custom field)

{% hint style="info" %}
**Note**: Of course, only subcategories are displayed if a category has visible subcategories and Shopware provides them in the corresponding category tree.
{% endhint %}

#### don't show

This is the default setting. In this case, the "Listing subcategories" will not be displayed on the corresponding page type.

#### show

If you select the option `show`, the "Listing subcategories" will be displayed on all pages of the corresponding page type.

{% hint style="success" %}
**Tip**: You can use the custom field to prevent the "Listing subcategories" from being displayed in a category, allowing you to customise selected categories individually.
{% endhint %}

#### show (via custom field)

If you select `show (via custom field)`, the "Listing subcategories" will only be displayed on the corresponding page type if you have configured the custom field to `yes` in the corresponding category.

<figure><img src="/files/VWqA8dDJwYoN77ALHCj5" alt=""><figcaption></figcaption></figure>

## Basic configuration

Here you select the **layout type** (image only, text only or text below the image) and set the horizontal **content alignment**.

## Image configuration

Here you define the **display mode** of the images (cropped/cover or fixed height/contain) as well as **width**, **height** and minimum/maximum height.

## Colour configuration

Here you adjust the colours: **text, background and border colour** (each also for the hover state) as well as the **background colour of the image**.

## Typography

Here you set the **font family**, **font size**, **font weight** and **text formatting**.

## Grid configuration

Here you define the **number of columns per breakpoint** (phone, tablet, desktop) – i.e. how many subcategories are displayed per row.

## Pagespeed configuration

Here you control the **lazy loading** of the images (eager or lazy) for loading performance.

***

## Layout types

There are currently 3 different display modes available (see screenshots below):

* Text only
* Image only
* Text below the image

<figure><img src="/files/cLtAe9a0WdGFlvSMZDAa" alt=""><figcaption><p>Text only</p></figcaption></figure>

<figure><img src="/files/tgZ1BWrj2br267MFfX0m" alt=""><figcaption><p>Image only</p></figcaption></figure>

<figure><img src="/files/V2DOp6lNsp2ZKXIojkei" alt=""><figcaption><p>Text below the image</p></figcaption></figure>

<figure><img src="/files/7gIFOrCHTDjLAtebLCma" alt=""><figcaption><p>Mobile representation (all layout types)</p></figcaption></figure>

***

## Custom field

From ThemeWare® 3.2.4, you can enable/disable this global subcategory navigation in selected categories using a custom field.

{% content-ref url="/pages/sFa2Ozmn0dtKkqVXsqGt" %}
[Listing subcategories](/additional-features/custom-fields/categories/listing-subcategories.md)
{% endcontent-ref %}

***

## Summary

#### Theme configuration

* Tab "Extensions" => Block "Listing subcategories (on listing pages)" => Show 'Listing subcategories' (CMS listing pages)

#### Custom field

* [Listing subcategories](/additional-features/custom-fields/categories/listing-subcategories.md)

***

## Further information

For more flexibility, the Pro Edition offers the CMS element of the same name – it lets you position the subcategories freely as a CMS block in your layouts:

{% content-ref url="/pages/8qY8a4dCijjqz9qLCsll" %}
[Listing subcategories](/additional-features/cms-extensions/cms-elements/listing-page/listing-subcategories.md)
{% endcontent-ref %}