PrestaShop

CookiePilot module for PrestaShop with Consent Mode v2

Upload one ZIP in the Module Manager, connect your shop domain and the module serves the consent banner from the head of every storefront page. The module supports PrestaShop 8.x and 9.x.

Requirements and supported versions

  • The module supports PrestaShop 8.x and 9.x.
  • Back office access with permission to install modules.
  • A CookiePilot account. You can register, verify your e-mail and log in directly inside the module.
  • The module ZIP, version 1.0.0, downloaded from the link below. Do not unpack it.

Download the module

Download the official CookiePilot installation ZIP, save it, and upload it to PrestaShop without unpacking it.

Download the ZIP

Install the ZIP in the Module Manager

  1. 1.In the back office open Modules, then Module Manager, and click Upload a module.
  2. 2.Drop the downloaded ZIP into the upload dialog. PrestaShop installs it and lists it as CookiePilot CMP.
  3. 3.Click Configure on the CookiePilot CMP entry to open the module configuration page.
  4. 4.If the upload is rejected, check that your shop runs PrestaShop 8.x or 9.x and that the ZIP is the original, unmodified file.

Register, verify your e-mail and connect the shop

  1. 1.On the configuration page create a CookiePilot account or log in to an existing one. Registration needs an e-mail address and a password.
  2. 2.Confirm the verification e-mail, return to the PrestaShop Back Office, reopen the CookiePilot CMP configuration, and log in with the verified account if needed.
  3. 3.Connect the shop: the module creates the domain in your CookiePilot account automatically, or reconnects to an existing domain with the same host name.
  4. 4.The Shop connection panel then shows the connected domain, the account and the current plan, with the status CONNECTED.

Where the script is injected

  1. 1.The module injects one CookiePilot script into the head of every storefront page and uses an early module hook. Scripts inserted earlier directly in the theme can still run first, so configure CookiePilot autoblocking to block them or configure them in GTM to wait for consent.
  2. 2.If a manually pasted CookiePilot snippet or another consent banner already exists in your theme or in a tag container, remove it. Two consent layers on one page compete for the consent state and corrupt measurement.
  3. 3.The Storefront status panel has one switch, Enable CookiePilot banner and Consent Mode, so you can confirm at any time whether the script is being served.

Consent Mode v2 mapping

  1. 1.The module sets Google Consent Mode v2 defaults to denied before the visitor makes any choice. Analytics and marketing storage stay denied until consent exists.
  2. 2.Accept All grants every category. Reject All keeps every category denied. Granular consent grants exactly the categories the visitor selected in the settings view.
  3. 3.Optional static and dynamic scripts registered in the module are blocked and released by the same categories, so a script only runs when its category is granted.

Multistore behaviour

  1. 1.In a multistore installation the configuration is stored per shop. Each shop connects its own domain and keeps its own keys.
  2. 2.A newly created shop does not inherit the keys of the owner shop. Open the module configuration in the context of each shop and connect it separately.

Tracker tests in five states

Run each state in a fresh private session and keep the Network tab open. These five states are the acceptance test the module itself is verified against.

Before consent: while the banner is still open, the Network tab shows no analytics or marketing requests and no tracking cookies are written.
Analytics only: grant just analytics in the granular view. Analytics requests start, marketing requests and marketing cookies stay absent.
Marketing only: grant just marketing. Marketing tags may fire while analytics storage stays denied.
Accept All: after all consents are accepted, analytics and marketing tools may run according to the store configuration.
Reject All: the shop keeps working, including cart and checkout, and trackers stay silent even after a reload.

Meta Pixel and TikTok Pixel do not read Consent Mode, so Consent Mode v2 alone does not stop them. They must be covered by the module autoblocking or fired through event gating only after marketing consent.

Disable, uninstall, reinstall

Disabling the module removes the CookiePilot script from the storefront. The domain in your CookiePilot account stays untouched.

Uninstalling removes the local secrets and the hooks from the shop database. It does not delete the remote domain and it does not delete the stored consent evidence.

Reinstalling the module and reconnecting the same domain works: the module attaches to the existing domain again instead of creating a duplicate.

Troubleshooting

The banner does not appear after installation

Clear the PrestaShop cache under Advanced Parameters, Performance, and purge your CDN if you use one. Cached HTML keeps serving pages generated before the module was enabled.

Two banners or a conflicting consent state

Remove any manually pasted consent snippet from the theme, from hosting tools and from tag containers. Exactly one consent layer may run, and the module already injects it once.

Trackers fire before the banner

A theme or another module that hardcodes GA4, Meta or TikTok can load outside the consent layer. Configure CookiePilot automatic blocking to block or cover those tags, or configure them in GTM to run only after the required consent.

Google Tag Manager setups

Keep the module as the only consent source. Gate every GTM tag on the matching consent state or fire it after the consent update, and never paste a second CookiePilot loader into the container.

Meta or TikTok requests keep appearing

These pixels ignore Consent Mode. Confirm they are covered by autoblocking or event gating; a pixel hardcoded in the theme keeps firing until it is moved behind marketing consent.

Install the module and test your shop

Download the ZIP, connect your domain and run the five tracker states in a clean session. The whole setup happens in the back office.