# Listing subcategories

The navigation automatically displays the subcategories of the current category in small tiles. Name and image are based on the corresponding information in the category management of Shopware.

This CMS extension is made up of various "components":

* [Content (Category text and image)](#content)
* [Theme configuration](#theme-configuration)
* [Element configuration](#element-configuration)

The CMS extension "Listing subcategories" is based on the theme extension of the same name. Both extensions are configured via the theme configuration.

In contrast to the theme extension, the CMS extension can be positioned freely and you can overwrite the theme configuration with the configuration of the CMS element. In addition, the CMS extension provides you with additional layouts.

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

{% hint style="info" %}
**Note**: The CMS extension "Listing subcategories" was developed for CMS pages of the type "Lising page", i.e. pages with (product) listings.
{% endhint %}

{% hint style="info" %}
**Note:** Subcategories are currently only displayed in Shopware 6 for the main category.
{% endhint %}

{% hint style="warning" %}
**Important**: This element is only available in the ThemeWare® Pro Edition.
{% endhint %}

{% hint style="success" %}
**Tip**: In the Cloud Edition, the theme extension of the same name is available: [Listing subcategories](/additional-features/extensions/listing-subcategories.md)
{% endhint %}

***

## Configure element

You can configure the ThemeWare® "Listing subcategories" as follows:

1. Click on the corresponding CMS block (1) to activate the "edit mode"
2. Hover the mouse over the desired CMS element
3. Click on the ![](/files/DbqYtMQUPw13wmi62Oiq) "gear" icon (2) to configure the CMS element
4. The "Element Settings" pop-up will open
5. Make the desired changes
6. Save your changes

You have now configured the CMS element.

***

## Content

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.

***

## Theme configuration

This CMS extension "Subcategories in Listing" is based on the theme extension of the same name. Both extensions are configured via the theme configuration:

> Tab "Extensions" => Block "Listing subcategories"

{% hint style="info" %}
**Note**: You do not need to activate the theme extension to use the CMS extension.
{% endhint %}

***

## Element configuration

The actual configuration of the "Listing subcategories" can be found in the tab 'Extensions' in the ThemeWare® configuration.

### Layout

In the tab "Layout" you can activate a individual configuration for the element. This allows you to overwrite a few "global" configurations from the theme configuration.

### Grid

In the tab "Grid" you can configure the number of columns in different viewports.

### SEO & Pagespeed

In the tab "SEO & Pagespeed" you can configure the "Lazy loading" of the images.

### Advanced

You can select each HTML element of our CMS elements using the appropriate CSS classes. If you want to use your own CSS classes, you can insert them in the "Advanced" tab.

***

## Layout types

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

* Button
* Buttons (Outline)
* Text only
* Image only
* Text below the image
* Text next to the image

### Screenshots

<figure><img src="/files/C89voQwQ64pcmXLxhDJd" alt=""><figcaption><p>Button</p></figcaption></figure>

<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/DXP2legDwV0EF9WsTPbR" alt=""><figcaption><p>Text next to the image</p></figcaption></figure>

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

***

## **Demo**

You can find some examples of use in our demo shops:

{% embed url="<https://demo.themeware.design/modern/en/Shop/Clothing-Fashion/>" %}
ThemeWare® Demoshop => Listing subcategories (Button style)
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.themeware.design/additional-features/cms-extensions/cms-elements/listing-page/listing-subcategories.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.