Troubleshooting

For merchants

The storefront does not change

1. Is the theme assigned? Sales Channels → (your storefront) → Theme must show KmhBaseTheme. Installing the plugin alone changes nothing. See Installation → Assign the theme.
2. Is the plugin active? Extensions → My extensions → Base Theme: the toggle must be on.
3. Was the theme compiled? Run bin/console theme:compile and bin/console cache:clear, or save the theme once under Content → Themes → KmhBaseTheme.
4. Browser or proxy cache — reload with the cache bypassed (Shift + reload) or open a private window. With a reverse proxy or CDN in front of the shop, purge it as well.

A setting has no effect

• Saved and compiled? Most settings take effect when the theme is compiled. Click Save in the theme manager, wait for it to finish, and reload the storefront with the cache bypassed. After changing settings from the command line, run bin/console theme:compile.
• Right theme? Settings belong to the theme you edit. If the storefront uses a duplicate or child theme, edit that one.
• A standard colour field (Primary, Secondary, Border, Background, Text, Headline, Price, Buy button, Buy button text)? These have little or no visible effect in this theme — see Theme configuration → Colours.
• Show top bar off, but the top bar is still there? It is always shown when the storefront has more than one language or currency. See Storefront → Top bar.
• Grid columns changed, but sliders did not? The grid settings apply to category and search listings only.
• Navigation style only changes the desktop navigation; phones always use the off-canvas menu.

The dark-mode button is missing

• Components → Dark mode toggle must be on, then Save.
• A child theme or another plugin that overrides the header's account action (layout_header_actions_account) without calling parent() removes the button. Ask your developer — see Developer → Template blocks.

The dark-mode choice is not remembered

The choice is stored in the visitor's browser (local storage). It is lost or not saved when:

• the visitor browses in a private window, or clears site data;
• the browser blocks storage for the site;
• the visitor uses another browser or device.

Every new visitor starts in light mode; the device's dark-mode setting is not followed.

Something looks wrong in dark mode

• Logo invisible or in strange colours — the desktop logo is inverted in dark mode. For a coloured logo upload a light version to Media → Dark mode logo (optional). See Dark mode → Logo.
• A white box on a dark page in a Shopping Experiences layout — background colours set in the layout are kept. Remove the background or pick one that works in both modes.
• A part of a third-party plugin stays white or turns dark-on-dark — that plugin uses its own fixed colours. The theme covers Shopware's core and the Kommandhub plugins. Your developer can map the element to the theme's tokens — see Customising.

The logo is the Kommandhub logo

The theme ships with the Kommandhub logo as a placeholder. Upload your own under Content → Themes → KmhBaseTheme → Media (desktop, tablet, mobile, share logo and favicon), then Save.

Cannot deactivate or uninstall the plugin

Shopware refuses while the theme is assigned to a sales channel. Assign another theme to each of those sales channels first — see Installation → Uninstalling.

Known issues

• The standard Shopware colour fields Primary, Secondary, Border, Background, Text, Headline, Price, Buy button and Buy button text are shown in the theme manager but are overridden by the theme's fixed palette.
• The number fields (grid columns, footer columns, content max-width) are not validated; 0, negative or decimal values give a broken layout.
• Show top bar cannot hide the top bar when the storefront has more than one language or currency; with one of each and the setting on, the bar is shown empty.
• Dark mode does not follow the device's colour-scheme preference.
• The footer always shows the desktop logo; if the desktop logo is removed, the footer shows a broken image.

Still stuck?

Open a GitHub issue with your Shopware version, the page URL and a screenshot in light and dark mode, or contact kommandhub.com/support.