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.

ThemeWare® "Listing subcategories"

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.

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.

Guide: You can find a step-by-step guide in the ThemeWare® Wiki: Showing subcategories in the listing

---

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

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

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

Shopware 6 "Category managment"

---

Display options

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

• don't show

• show

• show (via custom field)

Note: Of course, only subcategories are displayed if a category has visible subcategories and Shopware provides them in the corresponding category tree.

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.

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.

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.

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

Text only

Image only

Text below the image

Mobile representation (all layout types)

---

Custom field

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

Listing subcategories

---

Summary

Theme configuration

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

Custom field

• Listing subcategories

---

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:

Listing subcategories