# More category levels in the Shopware menu: setup manual

> Manual for the Category Level Settings plugin: installation, levels per sales channel, layout of long lists, linking parent entries, diagnostics and licence.

Quelle / Source: https://stoneandwater.online/en/manual-category-levels.html

# Category Levels manual.

Installation, level depth per area and sales channel, layout of long lists, linking parent entries, diagnostics and licence. As of version 1.0.34.
[To the product page](https://stoneandwater.online/en/category-levels.html)[Get in touch](https://stoneandwater.online/en/contact.html)

#### Contents

/

## System requirements

Shopware 6.7 with storefront, PHP 8.2 or newer. The plugin works on the category navigation and requires `shopware/core` and `shopware/storefront` in version 6.7.
**No theme build needed:** the layout is handled by an embedded stylesheet. A `theme:compile` is not required after installation.

## Installation

Upload the ZIP in the Shopware admin under Extensions, My Extensions, then install and activate it. Afterwards enter the licence key, see Licence.
Clear the cache once after activating. The plugin registers a service that appends to the finished page, and that only takes effect after the container has been rebuilt.

## Opening the settings

The plugin comes with its own admin module. It sits inside the Stone & Water plugin suite and is called **Category Level Settings**.
The sales channel is selected at the top of the page. Everything below applies to that channel. Where no value is set, the respective default applies.

## Main navigation levels

**Default: 3.** Number of category levels in the header menu, adjustable between 2 and 10. The default matches Shopware behaviour without the plugin exactly.
Counting starts at the first category level. At 3 the customer sees the menu bar entries, their children and one further step. At 4 one more step is added.
**Check first, then set:** a value higher than the depth actually present has no effect, but does no harm either. How deep the tree really goes is shown by the diagnostics.

## Sidebar levels

**Default: 3.** Number of levels in the sidebar category navigation, that is the category navigation CMS element. The value is independent of the main navigation.
At their core both areas use the same service. The plugin remembers per request which area the call came from and raises the depth only there. The offcanvas menu on mobile is left untouched and keeps the theme behaviour.

## Per sales channel

All settings apply per sales channel. The channel is selected at the top of the page and saving affects only that channel. A B2B channel with a deep spare parts tree can therefore be set up differently from a lean consumer shop in the same system.

## Checking existing levels

The button **Check levels in the shop** counts how many category levels actually exist in the selected sales channel and shows the number of categories per level. That removes the guesswork about which value will have any effect.

## Long lists in columns

**Default: 3 columns.** Maximum number of columns for long category lists, selectable as off, 2, 3 or 4.
The setting is an upper limit, not a fixed value. How many columns are needed is worked out in the shop from the number of entries and the space remaining below. A list of twelve entries stays in one column if it fits on screen anyway.
The original menu width serves as the column width. Labels therefore stay exactly as readable as before, there are simply several blocks side by side. If the menu is too narrow for the calculated number of columns, it is widened exactly as far as needed and shifted left where necessary so it stays within the window.
**Nested submenus are excluded:** if an entry of the list itself carries a submenu, that list is left unchanged. It would otherwise be clipped when opened.

## Wrap from

**Default: 10 entries.** From how many entries a list becomes multi-column at all, adjustable between 4 and 40. Short lists are left alone.

## Prevent overflow

**Default: on.** Limits the height of a long list to the visible area. The height is rounded down to a multiple of the row height, so the box always ends flush with an entry edge and no entry is cut in half.
If the content fits the calculated columns there is no scrolling at all. If it does not, the list scrolls vertically without the page behind it moving along.

## Linking parent entries

**Default: on.** An entry with a submenu opens its own category page when clicked.
Many themes attach a toggle to such entries which swallows the click, sometimes through an element placed on top of the link. The entry can then no longer be opened although the category has a page of its own. The plugin intercepts the click one step earlier and clears the way to the category.
While the submenu is still closed, the first click keeps opening it. Only once it is open does a click on the parent entry lead to the category. On mobile this produces the familiar pattern: tap once to open, tap again to go there.
**Opening in a new tab still works:** middle click and clicks with the Ctrl or Command key held are not touched.

## Indenting deep levels

**Default: off.** Indents submenus of deeper levels and puts a fine line in front of them so the nesting stays recognisable. The indentation is drawn purely in the stylesheet, the theme markup is left unchanged.

## Storefront diagnostics

If the layout does not look as expected, the parameter `?stawcd=debug` in the address helps. The plugin then writes a report to the browser console:

- the active settings as an overview

- how many lists the rule matches, with column count, height and width

- all category containers in the document grouped by build form

- per longer list each condition individually, so it is readable which one fails

- all entries with a submenu including link and category identifier

Without the parameter the plugin outputs nothing, so in normal shop operation the console stays quiet.

## Caching and hosting

After saving, the plugin invalidates the affected navigation cache entries automatically. If a reverse proxy or CDN sits in front of the shop, its cache has to be cleared as well.
Nothing is loaded afterwards in the storefront and nothing is sent to a third-party server. The stylesheet sits in the page and the column calculation runs in the browser.

## Licence

The licence key is assigned through the Stone & Water plugin suite. Validation runs against our licence platform and is cached; the storefront reads only that cache. If the server is unreachable, the last known state remains in force.
Without a valid licence the settings do not take effect in the storefront and the shop behaves as it would without the plugin. A notice appears in the settings in that case.

## Troubleshooting

**The additional levels do not appear.** Use the diagnostics to check how many levels exist in the sales channel at all, then clear the storefront cache.
**The list still runs off the screen.** Open the page with `?stawcd=debug`. If there is no output, the plugin is not in the page, which points to activation, licence or a missing cache run. If it says *matched by the rule: 0*, the list below shows which condition fails.
**A parent entry cannot be clicked.** Check under *entries with a submenu* in the diagnostics whether a link or a category identifier is reported. If neither is there, the theme does not output any reference to the category at that point.
**Nothing changes after the update.** Clear the cache and reload the page hard so the browser does not keep using the old stylesheet.

## Support

Questions, requests and bug reports come straight to us. In the admin module the **Request feature** button leads to the right address; alternatively use the [contact page](https://stoneandwater.online/en/contact.html) or call +49 2555 9997342.

## All settings

Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.0.34).

### Navigation levels

**Plugin active** Default: on
While the plugin is disabled the shop behaves exactly as it would without it.

**Main navigation** Default: 3 levels
Number of category levels in the main menu including the flyout. Level 1 is the menu bar itself. Allowed: 2 to 10 levels.

**Sidebar category navigation** Default: 3 levels
Number of category levels in the CMS element "Category navigation", meaning the category list in the sidebar. Allowed: 2 to 10 levels.

**Link parent entries** Default: on
An entry with a submenu opens its own category page when clicked. Many themes attach a toggle there which swallows the click, so the entry can no longer be opened. While the submenu is still closed, the first click keeps opening it.

**Indent deep levels** Default: off
Visually indents level 3 and below so deep nesting stays readable.

### Display of long lists

Shopware neither limits the height of the menu nor wraps long lists. With many subcategories the deepest level therefore runs off the screen. These two settings take care of that.
**Wrap long lists into columns** Default: 3 columns
Maximum number of columns. How many are actually needed is determined in the shop from the number of entries and the free space. If the menu is too narrow for that, it is widened exactly as far as needed and stays within the screen. Choose off, 2, 3 or 4 columns.

**Wrap from** Default: 10 entries
Shorter lists stay in a single column. Choose 4 to 40 entries.

**Prevent overflow** Default: on
Limits the height to the visible area and shows a scrollbar if needed, so nothing is ever cut off.

## Availability

Directly from Stone & Water

### Available now

Monthly 2,99 €
Best value Yearly 30,50 € 15 % cheaper

All prices net, plus VAT.
Download the free Plugin Suite and upload it in the admin, no SSH needed. It installs and updates the plugin with one click. You buy the licence directly from us, with an invoice from us and support straight from the developer.
[Download Plugin Suite](https://stoneandwater.online/en/plugin-suite.html)[+49 2555 9997342](tel:+4925559997342)

Shopware Store

### In preparation

The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available.

[Image: Stone & Water]
Shopware e-commerce agency from Schöppingen, Germany. Consulting, implementation and optimisation - from the first concept to long-term growth.

### Shopware

- [Shopware overview](https://stoneandwater.online/en/shopware.html)

- [Migration (5 to 6)](https://stoneandwater.online/en/shopware-migration.html)

- [SEO optimisation](https://stoneandwater.online/en/shopware-seo.html)

- [Performance](https://stoneandwater.online/en/shopware-performance.html)

- [Template development](https://stoneandwater.online/en/shopware-template-development.html)

- [Plugin development](https://stoneandwater.online/en/shopware-plugin-development.html)

- [PIM for Shopware](https://stoneandwater.online/en/pim.html)

- [Shopware Plugins](https://stoneandwater.online/en/plugins.html)

### Plugins

[Plugin Suite free ](https://stoneandwater.online/en/plugin-suite.html)[All plugins](https://stoneandwater.online/en/plugins.html)[All videos](https://stoneandwater.online/en/videos.html)

- [A/B Testing](https://stoneandwater.online/en/ab-testing.html)

- [AI Blog & Landing Page](https://stoneandwater.online/en/ai-landingpage.html)

- [AI Content Blocks](https://stoneandwater.online/en/ai-content-blocks.html)

- [AI Cross-Selling](https://stoneandwater.online/en/ki-cross-selling.html)

- [AI Image Badge](https://stoneandwater.online/en/ai-image-badge.html)

- [AI Image SEO](https://stoneandwater.online/en/ai-image-seo.html)

- [AI Newsletter](https://stoneandwater.online/en/ai-newsletter.html)

- [AI Newsletter Agent](https://stoneandwater.online/en/ai-newsletter-agent.html)

- [AI Product Advisor](https://stoneandwater.online/en/ki-product-advisor.html)

- [AI Product Bundles](https://stoneandwater.online/en/ai-product-bundles.html)

- [AI Product Questions](https://stoneandwater.online/en/ki-product-questions.html)

- [AI Product Search](https://stoneandwater.online/en/ki-product-search.html)

- [AI Product Videos](https://stoneandwater.online/en/ai-product-videos.html)

- [AI Translation Manager](https://stoneandwater.online/en/ai-translation-manager.html)

- [Category Levels](https://stoneandwater.online/en/category-levels.html)

- [CLP Information](https://stoneandwater.online/en/clp-information.html)

- [Cross-selling at checkout](https://stoneandwater.online/en/checkout-cross-selling.html)

- [Crypto Payment](https://stoneandwater.online/en/crypto-payment.html)

- [Customer Reviews](https://stoneandwater.online/en/customer-reviews.html)

- [Database Cleanup & Optimizer](https://stoneandwater.online/en/db-cleaner.html)

- [Lite YouTube](https://stoneandwater.online/en/lite-youtube.html)

- [Live Viewer & Sales Counter](https://stoneandwater.online/en/live-viewer.html)

- [Manufacturer Pages](https://stoneandwater.online/en/manufacturer-pages.html)

- [Page Speed Optimization](https://stoneandwater.online/en/page-speed.html)

- [Payment information on PDF documents](https://stoneandwater.online/en/payment-info-pdf.html)

- [Plugin Update Manager](https://stoneandwater.online/en/update-manager.html)

- [Read More - Description](https://stoneandwater.online/en/read-more.html)

- [robots.txt Manager](https://stoneandwater.online/en/robots-txt.html)

- [Shipping Calculator](https://stoneandwater.online/en/shipping-calculator.html)

- [Shopping Like Dating](https://stoneandwater.online/en/shopping-like-dating.html)

- [Variant preselection](https://stoneandwater.online/en/variant-preselection.html)

More plugins [ALBIS Leasing](https://stoneandwater.online/en/albis-leasing.html)[Cache Warmer](https://stoneandwater.online/en/cache-warmer.html)[Shopware CDN](https://stoneandwater.online/en/shopware-cdn.html)

### Company

- [Contact](https://stoneandwater.online/en/contact.html)

- [Legal notice](https://stoneandwater.online/en/legal-notice.html)

- [Privacy](https://stoneandwater.online/en/privacy.html)

- Cookie settings

© 2026 Stone & Water · Dominic Steiner Hosted on [Creoline](https://www.creoline.com/ref/tYq4UkumEqLtMCi3PpwEJo9JspG66udf) [LinkedIn](https://www.linkedin.com/company/18043592/) · [Xing](https://www.xing.com/pages/stone-water) · [Facebook](https://www.facebook.com/stoneandwateragency/)

</html
