> For the complete documentation index, see [llms.txt](https://docs.nosto.com/shopware-6/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nosto.com/shopware-6/getting-started/guides/cookies.md).
# Cookies
This guide explains the Nosto usage of cookies
{% hint style="info" %}
**Disclaimer:** It is the merchant’s responsibility to ensure that all cookie-related features comply with the data-protection laws, regulations, and policies that apply in their specific country and region.
{% endhint %}
To ensure that the **Nosto Plugin** and the **Nosto Debug Toolbar** operate correctly, the following cookies must be accepted:
| Cookie | Purpose |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `2c.cid` | Visitor-specific identifier used by Nosto for analytics and personalisation. Set only when tracking is allowed (i.e. not in `doNotTrack` mode). |
| `nosto-integration-allowed` | Consent to load Nosto (essential). Replaces the former `nosto-integration-track-allow`, which is still honoured for shoppers who already consented. |
| `nosto-search-session-params` | Stores search-session parameters for more precise recommendations. |
| `nostoCookieFilter` | Includes all Search/Category merchandising filters and values |
| `nostoCookieFilterMapping` | Includes mapped Search/Category merchandising filters |
| `nosto_preview` | Used to preview Search/Category merchandising results without enabling it globally on a live store |
| `nosto-track` | Marketing consent: allows Nosto to send customer data and track the visit (no `doNotTrack`). |
***
### 1. Cookie-Consent Banner
When a customer visits the store for the first time after the Nosto Plugin has been installed, Shopware displays its cookie-consent banner. The plugin adds two consent options:
* A **Nosto** group - consent to load Nosto on the storefront.
* A **Nosto Marketing** entry under the **Marketing** group - consent to send customer data and enable full tracking.
> **Why it matters**\
> Nosto loads once the essential consent cookie (`nosto-integration-allowed`) is present. If the shopper accepts Nosto but **not** marketing, Nosto still loads but runs with **`doNotTrack`** enabled - no session identifier (`2c.cid`) is set and no customer data is sent. Accepting **Nosto Marketing** enables full tracking.
After accepting Shopware default cookie consent, cookie `nosto-search-session-params` is created which then allows Nosto script to load as well as other Nosto functionality.
{% hint style="warning" %}
Any information sent to Nosto with the requests activated by the implementation will still be processed normally by Nosto's service even when users have opted out of session tracking. Merchant should ensure necessary consent is obtained for this processing.
{% endhint %}
***
### 2. Send Customer Data to Nosto
Found under **Settings → Plugins → Nosto → Features flags**, this setting controls whether customer data (email, name) is sent to Nosto:
* **Rely on nosto\_track cookie** *(default)* — customer data is sent only when the shopper has accepted the marketing (`nosto-track`) cookie; otherwise Nosto runs with `doNotTrack`.
* **Always send** — customer data is always sent.
* **Never send** — customer data is never sent, and `doNotTrack` is enabled.
> **Info**\
> Backend synchronisation jobs (new orders, newsletter subscriptions) run server-side with no cookie available, so they send customer data only when this is set to **Always send**.
***
### 3. Nosto Debug Toolbar
The toolbar allows developers to inspect page-level Nosto events, placements, and requests while browsing the storefront.
**If you find the page load speeds a little slow, you can enable Nosto script initialization on the page interaction, that means that Nosto will only run after the user interacts with the page (scroll, click etc)**
1. Navigate to **Settings → Plugins → Nosto → All Sales Channels**.
2. In **General Settings**, enable **Initialize Nosto Script After First Page Iteration**.
***
### 4. Treat Nosto as an Essential Cookie
The **Treat Nosto as an essential cookie** setting (**Settings → Plugins → Nosto → Features flags**) decides whether Nosto may load without explicit consent. **It is enabled by default.**
* **Enabled (default)** - Nosto is registered as a technically required cookie and loads for every visitor, running in `doNotTrack` mode until marketing consent is given. This matches the behaviour of earlier plugin versions.
{% hint style="warning" %}
This feature does not disable cookies entirely. It only disables the `2c.cId` cookie that is used for identifying browsers between their visits to the site.
{% endhint %}
* **Disabled** - Nosto loads only after the shopper accepts the **Nosto** cookie group in the banner. If they decline it, Nosto is never loaded and sends no requests.
{% hint style="warning" %}
This may not work with third-party cookie-consent managers - in that case, follow their documentation to allow the Nosto cookies (see section 5)
{% endhint %}
#### Backend steps
1. Go to **Settings → Basic Information → Security and Privacy**.
2. Disable **Use default cookie notification**.
3. (Only if it was turned off) In **Settings → Plugins → Nosto**, make sure\
"Treat Nosto as an essential cookie" is enabled - it is enabled by default.
> **Optionally hide Shopware's banner entirely:** if explicit consent is not legally required in your region, go to **Settings → Basic Information → Security and Privacy** and disable **Use default cookie notification**. Combined with the setting enabled above, Nosto cookies are set automatically on first page load and no banner is shown.
***
### 5. Third-Party Cookie consent Manager (not Shopware default)
Third-party cookie-consent managers usually override Shopware's default banner. In that case, follow the specific manager's documentation and settings to allow the Nosto cookies.
This also means that if **Treat Nosto as an essential cookie** is enabled, it can still be blocked by a third-party manager unless configured within its settings.
Cookies that may need to be added explicitly:
* `2c.cid`
* `nosto-integration-allowed` *(load Nosto)*
* `nosto-track` *(marketing / send customer data)*
* `nosto-search-session-params`
* `nostoCookieFilter`
* `nostoCookieFilterMapping`
* `nosto_preview`
### 6. Summary Checklist
* Banner shows on first visit (unless the banner is hidden), offering the **Nosto** group and **Nosto Marketing**.
* `nosto-integration-allowed` is present after accepting Nosto; `nosto-track` after accepting marketing; `2c.cid` once tracking is allowed.
* **Send Customer Data To Nosto** is set to the desired mode (rely on cookie / always / never).
* (Optional) **Initialize Nosto Script After First Page Iteration** is enabled per sales channel.
* (Optional) **Treat Nosto as an essential cookie** is left enabled for automatic loading, or disabled for strict opt-in.
***
#### Need help?
If the toolbar does not appear or tracking seems incomplete, verify that:
If the toolbar does not appear or tracking seems incomplete, verify that:
* The required cookies are present in the browser's storage.
* No third-party script blockers are preventing Nosto from loading.
For additional assistance, contact **** or consult the Nosto developer documentation.
