Deutsche Version

Back to overview

Klaro Cookie Consent: Configuration

This documentation always describes the latest published version.

Plugin Settings

Navigate to Settings > Extensions > Klaro Cookie Consent Manager. All settings can be overridden per sales channel, so you can configure different shops differently.

Settings

General Settings

Consent Behavior

Storage Settings

Google Consent Mode v2

Styling

The banner position only applies when "Must Consent" is disabled. When "Must Consent" is enabled, a centered modal is shown instead.

Configuration keys

The settings are stored in the system configuration under the prefix MmdKlaroCookieConsent.config. and are read per sales channel:

Customizing texts via snippets

The texts of the consent categories and of the dialog are managed through Shopware snippets. This allows any number of languages, not just German and English. You find the snippet keys under Settings > Snippets with the prefix mmd-klaro.

Category texts

Tip: To add French, create a new snippet set for fr-FR and translate the texts. Klaro automatically displays the language of the shop in the storefront.

Dialog texts

Managing cookie services (admin module)

The plugin includes a dedicated admin module with native Shopware UX. You find the service management under Extensions > Cookie Consent Services.

graph LR
    A["Extensions"] --> B["Cookie Consent Services"]
    B --> C["Service list"]
    C --> D["Service detail"]
    D --> E["Language switcher"]
    E --> F["Title and description per language"]

Service list

The list shows all configured services with technical name, title and category, plus the "Required" and "Active" status as icons. Sorting and pagination are available, and the language switcher in the top right shows the titles in the selected language.

Creating and editing services

Click "Create service" or an existing service. In the header of the detail page you switch the language with the language switcher to manage title and description per language. This works like Shopware products or categories.

Important: The technical name cannot be changed after creation. It serves as the unique identifier in the Klaro configuration.

Service fields

The option "Enabled by default" is not GDPR compliant because it anticipates consent. Use it with caution.

If no sales channel is selected, the service is not shown in any sales channel.

Cookie deletion rules

For each service you can define cookies that are deleted automatically when consent is withdrawn:

Every rule needs a pattern. Remove rows you do not fill in.

Google Consent Mode v2

Since March 2024, Google requires Consent Mode v2 for websites that use Google Analytics or Google Ads in the European Economic Area. Enable it under Settings > Extensions > Klaro Cookie Consent Manager with the setting Enable Google Consent Mode v2.

graph TD
    A["Page load"] --> B["Google consent default: denied"]
    B --> C["Klaro initializes"]
    C --> D{"User interaction"}
    D -->|"Accepts"| E["gtag consent update: granted"]
    D -->|"Declines"| F["Consent stays denied"]
    E --> G["Google tags fire"]
    F --> H["No data collection"]

With Google Consent Mode enabled, the following happens:

1. Default state: Before any tag fires, ad_storage, ad_user_data, ad_personalization, analytics_storage, functionality_storage and personalization_storage are set to denied, and security_storage to granted. If "Wait for consent update" is active, wait_for_update with 500 milliseconds is added.
2. Ads data redaction: ads_data_redaction is set to true on load and switched to false as soon as marketing consent is granted.
3. Consent update: As soon as the user saves a decision, the Google keys are updated based on the category of the services.

The mapping depends on the category, not on the technical name of a service. A category for which no service is configured in a sales channel is left untouched and therefore does not override signals from other scripts or from Google Tag Manager.

Real-world examples

Google Analytics 4 (GA4)

Include your GA4 script with the data-name attribute so Klaro can control it:

<script data-type="application/javascript"
        data-name="google-analytics"
        data-src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXX"
        type="text/plain"></script>

YouTube (embedded videos)

The Klaro flag for contextual consent cannot be set in the admin form, see Troubleshooting.

Facebook Pixel

Shopware session (technically necessary)

This service is created automatically during installation: