Tarteaucitron est un script JavaScript open source et gratuit qui affiche un bandeau de consentement et bloque les services tiers tant que le visiteur n'a pas choisi. Il gère aussi le Consent Mode v2 de Google, avec l'option <em>googleConsentMode</em>.
Sa limite tient en une phrase. Pour afficher des annonces personnalisées AdSense ou Ad Manager à des visiteurs européens, Google exige une CMP certifiée et intégrée au TCF de l'IAB. Tarteaucitron convient donc à un site sans publicité Google, pas à un site qui en vit.
Le parcours
Les étapes de cette page, dans l’ordre.
-
01 Inventaire Lister les services tiers qui déposent des cookies.
-
02 Installation Le script en tête de page, avant tout service tiers.
-
03 Services Déclarer chaque outil avec son identifiant.
-
04 Consent Mode v2 Activer googleConsentMode, refus par défaut.
-
05 Contrôle Onglet Réseau : rien ne part avant le choix.
01 / 11
Tarteaucitron, c'est quoi exactement ?
Tarteaucitron est une bibliothèque JavaScript open source, sous licence MIT, qui affiche un bandeau de consentement et ne charge les services tiers qu'après l'accord du visiteur.
Le script est gratuit et son code est public sur GitHub. Vous l'hébergez sur votre propre serveur. Il retient le choix du visiteur dans un cookie et ne charge chaque service déclaré, mesure d'audience, vidéo ou carte, qu'une fois ce service accepté.
L'éditeur propose aussi une offre payante. Elle ajoute une console en ligne pour régler la bannière, des statistiques de consentement exportables en CSV et la gestion automatique des signaux Consent Mode pour GA4 et Google Ads (tarteaucitron.io, lu le 03/11/2026). L'outil ne rédige ni votre politique de cookies ni votre registre : pour le texte à afficher, voyez quel message RGPD afficher sur un site.
Le blocage avant consentement
Aucun script tiers ne s'exécute tant que le visiteur n'a pas répondu. C'est le cœur du mécanisme, et c'est ce que vérifie un contrôle.
Le point cléTestez toujours le site en navigation privée avant consentement.
L'auto-hébergement
Les fichiers sont servis depuis votre domaine. Aucune donnée de consentement ne transite par un prestataire, mais personne ne met à jour le code à votre place.
Le point cléNotez quelque part la version installée et la date de mise à jour.
Le périmètre à ne pas confondre
Tarteaucitron gère le choix du visiteur et le blocage. Il ne rédige pas votre politique de cookies ni votre registre.
Le point cléLa page de politique de confidentialité reste à votre charge.
02 / 11
Comment bloquer un script tiers tant que le visiteur n'a pas accepté ?
Le script garde les services tiers inactifs jusqu'au choix du visiteur. Seuls les services déclarés dans sa configuration sont bloqués : tout le reste part sans attendre.
Un service ajouté directement dans le thème, par un module ou par une extension échappe au mécanisme. La page s'affiche normalement, mais le traceur part avant le choix. C'est la fuite la plus courante, et elle ne se voit pas à l'œil nu.
Pour la repérer, ouvrez les outils de développement du navigateur, onglet Réseau, et testez trois cas : navigation privée sans répondre, refus total, acceptation d'un seul service. Aucune requête vers un domaine tiers ne doit partir avant l'accord correspondant.
Tester avant tout choix
En navigation privée fraîche, sans toucher au bandeau, l'onglet Réseau ne doit montrer aucune requête vers les domaines tiers déclarés.
Tester le refus total
Refusez tous les services, puis rechargez : les requêtes doivent rester absentes et le choix doit être mémorisé.
Tester une acceptation sélective
Acceptez un seul service et vérifiez que seul son domaine apparaît dans l'onglet Réseau, pas les autres.
Tester le dépôt de cookie
Dans l'onglet Stockage, aucun cookie non essentiel ne doit exister avant acceptation. Le cookie de mémorisation du choix est, lui, légitime.
Tester sur mobile
Les thèmes récents masquent parfois le bandeau derrière un menu. Vérifiez qu'il reste visible et utilisable au doigt.
-
Étape 02.1 À la première visite, le bandeau s'affiche et la carte Google Maps est remplacée par un message « désactivé ». Après « Tout refuser » et un rechargement, le bandeau a disparu et la carte reste bloquée. (14 s) Tout refuser et vérifier le choix retenu
En navigation privée, ouvrez la page sans répondre, cliquez sur « Tout refuser », puis rechargez : le bandeau ne revient pas et les services restent bloqués.
-
Étape 02.2 Dans le panneau de gestion, Google Analytics est interdit et seul Google Maps Embed est autorisé : la carte se charge, la mesure d'audience reste bloquée. (17 s) Accepter un seul service
Cliquez sur « Personnaliser », interdisez la mesure d'audience, autorisez seulement la carte, puis fermez le panneau.
-
Étape 02.3 Le journal du navigateur de test ne montre aucune requête tierce sans réponse ni après refus ; après acceptation de la seule carte, seuls les domaines de Google Maps apparaissent, et aucun cookie autre que « tarteaucitron ». (11 s) Contrôler les requêtes tierces dans les trois cas
Relevez les requêtes vers des domaines tiers sans réponse, après refus total, puis après acceptation d'un seul service.
Pour approfondir
Comprendre l'ordre exact des opérations aide à repérer pourquoi un script peut encore partir alors que le bandeau s'affiche correctement.
Comment le blocage opère
Concept
Le mécanisme du blocage, étape par étape
Une intégration ajoutée par un module, un thème ou une extension, en dehors du mécanisme de la bibliothèque, se charge avant que le choix du visiteur ne soit connu : c'est la fuite la plus fréquente et la plus difficile à voir.

Exemple illustratif : sur le site d'une PME, le bandeau s'affiche et tout semble réglé. Pourtant, l'outil de mesure reçoit des visites de personnes qui ont refusé. La cause : une intégration du même outil, ajoutée dans un module de pied de page, se charge hors du script.
Le choix du visiteur est conservé dans un cookie sur le domaine du site. À chaque page, le script lit ce cookie et ne charge que les services acceptés. Tout service qui n'est pas déclaré dans sa configuration se charge sans le consulter.
Sur un site à plusieurs gabarits ou plusieurs langues, chaque gabarit doit appeler le script. Un gabarit oublié laisse ses pages sans blocage.
- Chercher les intégrations hors bibliothèqueRecherchez le nom de domaine du service dans tous les fichiers du thème : les appels directs oubliés apparaissent, et il faut alors les retirer ou les raccorder au mécanisme.
- Vérifier l'ordre de chargementDans le code source de la page, l'appel de la bibliothèque doit précéder tout script tiers. Si un service apparaît avant, il échappe au blocage.
- Contrôler chaque gabaritPages d'atterrissage, blogs, boutiques et pages système doivent tous inclure le même appel : un gabarit oublié laisse ses pages non bloquées.
03 / 11
Comment déclarer Google Analytics, Matomo, Google Fonts et les autres services ?
Les services courants ont un modèle prêt à l'emploi : vous ajoutez le service et son identifiant. Un outil sans modèle se déclare en service personnalisé.
Pour Google Analytics, Matomo, YouTube ou une carte, la bibliothèque fournit le code d'intégration : il suffit d'indiquer l'identifiant du compte, copié depuis la console de l'outil. Les polices chargées depuis un domaine tiers transmettent l'adresse IP du visiteur : déclarez-les aussi, ou hébergez-les sur votre serveur. Pour Google Analytics 4 en particulier, voyez les contrôles à faire avant de suivre.
Les services courants
Mesure d'audience, cartes, vidéos intégrées et boutons de partage disposent de modèles fournis avec la bibliothèque. Il suffit de renseigner l'identifiant de suivi.
- Forme de l'identifiant
- propre à chaque outil
- Où le trouver
- console de l'éditeur
Le point cléCopiez l'identifiant depuis la console de l'outil, jamais depuis un ancien projet.
Les services personnalisés
Un outil sans modèle s'ajoute en mode personnalisé : vous collez le code d'intégration dans la zone prévue et il n'est exécuté qu'après accord.
Le point cléNommez le service clairement, le visiteur doit comprendre ce qu'il accepte.
Les polices distantes
Charger une police depuis un domaine tiers transmet l'adresse IP du visiteur sans consentement. Le service doit figurer dans la liste ou la police être hébergée sur votre serveur.
Le point cléL'auto-hébergement des polices supprime le problème à la racine.
La personnalisation du bandeau
Couleurs, position, textes, langue et bouton de refus se règlent dans le même fichier de configuration. Le refus doit être aussi accessible que l'acceptation.
Le point cléPrévoyez un bouton « Tout refuser » visible au premier niveau, pas caché dans les réglages.
04 / 11
Tarteaucitron est-il compatible avec le Consent Mode v2 de Google ?
Oui. L'option googleConsentMode du script transmet le choix du visiteur au Consent Mode v2 de Google pour Google Ads et GA4.
Le Consent Mode v2 attend quatre signaux : ad_storage (cookies publicitaires), analytics_storage (cookies de mesure), ad_user_data (envoi de données utilisateur à Google pour la publicité) et ad_personalization (publicité personnalisée). Google précise que la valeur par défaut doit être définie avant toute commande qui envoie des données de mesure. Sinon, les valeurs par défaut ne fonctionnent pas.
Transmettre le Consent Mode ne suffit pas pour monétiser un site avec AdSense ou Ad Manager. Depuis le 16 janvier 2024 dans l'EEE et au Royaume-Uni, Google exige une CMP certifiée intégrée au TCF pour diffuser des annonces personnalisées. Le trafic d'une CMP non certifiée peut seulement recevoir des annonces non personnalisées ou limitées. Pour vérifier vos signaux, suivez notre méthode : vérifier Google Consent Mode v2.
Ce que Tarteaucitron couvre, et ce qu'il ne couvre pas
| Besoin du site | Couvert | Conséquence si non couvert |
|---|---|---|
| Bloquer les services avant consentement | Oui, pour les services déclarés | Un service non déclaré part sans attendre |
| Transmission au Consent Mode v2 | Oui, option googleConsentMode | Les conversions Google Ads et GA4 perdent les signaux |
| CMP certifiée Google et TCF | Non annoncée par l'éditeur | Pas d'annonces personnalisées AdSense ou Ad Manager en Europe |
| Statistiques de consentement | Offre payante (export CSV) | Pas de suivi du taux de consentement |
Sources : dépôt GitHub tarteaucitron.js, tarteaucitron.io et aide Google AdSense, lus le 03/11/2026.
Pour approfondir
Comprendre ce que Google attend réellement derrière le bandeau évite de chercher la panne du mauvais côté quand les revenus baissent.
Ce que le mode attend
Règle à connaître
Le Consent Mode v2, ce qu'il attend vraiment de vous
Un bandeau qui transmet bien les quatre signaux peut quand même priver un éditeur AdSense d'annonces personnalisées, si la CMP n'est pas certifiée par Google.

Exemple illustratif : un site de recettes financé par AdSense installe Tarteaucitron et active googleConsentMode. Les signaux partent bien, mais les visiteurs européens ne reçoivent plus d'annonces personnalisées. Aucun réglage du bandeau n'y change rien : la règle de Google porte sur la certification de la CMP.
Avant tout choix, les quatre signaux doivent valoir « refusé ». Un site qui cumule plusieurs balises Google, par exemple GA4 et une balise Google Ads ajoutée par un module, doit vérifier que chacune reçoit les signaux.
- Vérifier la valeur par défautAvant tout choix du visiteur, les quatre signaux doivent valoir « denied ». Contrôlez-le dans l'aperçu de Google Tag Manager ou dans la console.
- Contrôler chaque baliseRecensez les balises Google présentes, y compris celles d'un module, et confirmez que chacune reçoit les signaux.
- Vérifier la régieSi vous affichez AdSense ou Ad Manager en Europe, il vous faut une CMP de la liste des CMP certifiées par Google.
05 / 11
Que faut-il préparer avant de l'installer ?
Avant d'installer, listez tous les services tiers du site et vérifiez que vous pouvez modifier l'en-tête de toutes les pages.
Un bandeau ne bloque que ce qu'il connaît. Ouvrez l'onglet Réseau des outils de développement et notez chaque service qui dépose un cookie ou appelle un domaine tiers : mesure d'audience, cartes, vidéos, polices distantes, boutons sociaux, publicité. Cette liste devient votre configuration.
Il vous faut ensuite un accès aux fichiers du thème, ou à un emplacement qui insère du code dans l'en-tête de toutes les pages. Préparez enfin la politique de cookies : elle nomme chaque service et sa finalité, et le bandeau renvoie vers elle. Mettez-la en ligne en même temps.
06 / 11
Comment installer Tarteaucitron sur un site WordPress, PrestaShop ou en manuel ?
Déposez les fichiers du script sur votre serveur, appelez-le dans l'en-tête de chaque page avant tout service tiers, puis initialisez-le avec vos options.
Le dépôt GitHub décrit deux éléments : l'appel du fichier tarteaucitron.js, puis la fonction d'initialisation qui reçoit les options. Les principales sont l'adresse de votre politique de confidentialité, la position du bandeau, les boutons « Tout accepter » et « Tout refuser », et googleConsentMode. Les services se déclarent ensuite un par un.
Sur WordPress, l'éditeur indique la compatibilité : passez par un thème enfant, ou par une extension qui insère du code dans l'en-tête, pour ne pas perdre l'appel à la prochaine mise à jour du thème. Sur un site statique, placez l'appel dans le gabarit d'en-tête commun à toutes les pages.
-
Récupérer les fichiers
Téléchargez la bibliothèque depuis le dépôt GitHub officiel et déposez le dossier sur votre serveur. Notez la version installée.
-
Appeler le script en tête de page
L'appel doit être placé avant tout script tiers, sans quoi il arrive trop tard et les cookies sont déjà posés. Un ordre de chargement correct est la condition de réussite de toute l'installation.
-
Sur WordPress, passer par le thème enfant
Ajoutez l'appel dans l'en-tête du thème enfant, ou avec une extension d'insertion de code. Une modification du thème parent serait effacée à sa prochaine mise à jour.
-
Déclarer les services
Renseignez l'identifiant de suivi de chaque outil là où l'outil l'attend. Un service déclaré sans identifiant reste inerte : le script ne se charge jamais.
-
Tester en navigation privée
Ouvrez le site dans une fenêtre privée, refusez tout, puis vérifiez dans l'onglet Réseau du navigateur qu'aucune requête vers les domaines tiers n'est partie.
-
Étape 06.1 L'archive du tag v1.37.0 est téléchargée depuis le dépôt GitHub officiel puis décompressée ; package.json confirme la version 1.37.0, à noter pour les mises à jour. (13 s) Télécharger la bibliothèque et noter sa version
Téléchargez l'archive de la dernière version depuis le dépôt GitHub officiel, décompressez-la et notez sa version.
-
Étape 06.2 Dans le <head> de la page de test, l'appel de tarteaucitron.min.js et la fonction tarteaucitron.init passent avant tout script tiers, avec l'adresse de la politique de cookies, les boutons « Tout accepter » et « Tout refuser » et le Consent Mode. (11 s) Charger le script avant tout script tiers
Placez l'appel de tarteaucitron.js puis tarteaucitron.init en haut du <head>, avant tout script tiers.
07 / 11
Qu'est-ce qui rend un bandeau non conforme en pratique ?
Un bandeau devient irrégulier quand refuser est plus difficile qu'accepter, quand un service part avant le choix, ou quand vous ne pouvez pas prouver le consentement recueilli.
La CNIL demande que le refus soit aussi simple que l'acceptation. Un bouton « Tout refuser » caché au second niveau, ou moins visible que « Tout accepter », rend le consentement non valable. Le consentement doit aussi pouvoir être retiré à tout moment.
Vous devez enfin pouvoir démontrer le consentement recueilli. La CNIL cite plusieurs moyens : captures d'écran horodatées de l'interface, configuration documentée de l'outil de consentement, dépôt horodaté du code chez un tiers, audits réguliers. La version libre du script ne tient pas ces preuves pour vous. Pour tester votre bandeau comme un nouveau visiteur, commencez par effacer les cookies du site dans votre navigateur, puis refusez et vérifiez qu’aucun script tiers ne se charge.
Pour approfondir
Un bandeau qui fonctionne peut échouer sur la preuve : il faut pouvoir montrer ce qui était en place à une date donnée.
Ce que l'audit regarde
Méthode
Le contrôle côté preuve : ce qu'un audit réglementaire demande
Archivez à chaque changement une capture datée du bandeau, la configuration du script et la version de la politique de cookies.

Exemple illustratif : un site de santé a un bandeau correct, mais sa politique de cookies date de deux ans. Elle décrit des outils abandonnés et oublie deux services ajoutés depuis. Le bandeau bloque bien, mais la documentation ne correspond plus au site.
L'inventaire se périme à chaque nouveau module. Rejouez l'inspection des cookies après chaque ajout, mettez la politique à jour, et gardez une version datée de chaque état : capture du bandeau, fichier de configuration, politique.
- Archiver chaque version de la politiqueVérifiez qu'une date et un numéro de version sont conservés à chaque modification. Si vous ne retrouvez pas la version en vigueur à une date passée, vous ne pourrez pas répondre à un contrôle portant sur ce moment.
- Rejouer l'inventaire après chaque ajout d'outilAprès toute installation d'un module ou d'un script tiers, inspectez les cookies déposés et comparez avec votre politique. Tout cookie non déclaré crée un écart documentaire immédiat.
- Documenter le parcours de refusEnregistrez ou capturez le parcours de refus à une date donnée, en conservant la trace. Cette pièce datée devient utile si l'on vous demande comment le refus était présenté à ce moment-là.
08 / 11
Version auto-hébergée ou version avec interface : que choisir ?
La version libre suffit si quelqu'un peut installer et mettre à jour le script. L'offre payante de l'éditeur ajoute une console de réglage et des statistiques de consentement.
La version libre convient à un site vitrine, un blog ou une boutique qui ajoute rarement des services. Une fois installée, elle tourne seule, mais ses mises à jour sont à votre charge. Notez la version installée et surveillez le dépôt.
L'offre payante vise les sites qui changent souvent de services ou qui gèrent plusieurs sites. Elle couvre un nombre illimité de sites, propose plus de 50 réglages en 36 langues, et gère automatiquement les signaux Consent Mode (tarteaucitron.io). Dans les deux cas, l'inventaire des cookies reste à votre charge.
09 / 11
À quel moment faut-il passer à une autre solution ?
Changez d'outil si vous affichez de la publicité Google (AdSense, Ad Manager) à des visiteurs européens : il vous faut alors une CMP certifiée par Google.
Le critère est votre modèle économique, pas la taille du site. Sans régie Google, Tarteaucitron peut suffire durablement à un site vitrine, une boutique ou un site institutionnel. Avec AdSense ou Ad Manager en Europe, seule une CMP de la liste des CMP certifiées par Google permet les annonces personnalisées.
Changez aussi si personne ne peut maintenir le script. Un bandeau jamais mis à jour finit par manquer des services récents. Avant de choisir une CMP payante, vérifiez qu'elle figure sur la liste de Google si vous en avez besoin, et comparez ses offres sur le site de l'éditeur.
10 / 11
Faut-il un bandeau pour la seule mesure d'audience ?
Pas toujours. La CNIL exempte de consentement certains traceurs de mesure d'audience, s'ils se limitent à des statistiques anonymes pour le seul compte de l'éditeur.
Selon la CNIL, ces traceurs doivent servir uniquement à mesurer l'audience du site, pour le compte exclusif de l'éditeur, et produire des statistiques anonymes. Ils ne doivent ni croiser les données avec d'autres traitements, ni suivre la personne d'un site à l'autre. La CNIL recommande une durée de vie de 13 mois au plus et une conservation de 25 mois au plus.
Une offre dont le fournisseur réutilise les données pour son propre compte sort de l'exemption. Si votre seul service est une mesure exemptée, aucun bandeau n'est exigé pour elle. Dès que vous ajoutez une vidéo, une carte ou un outil publicitaire, Tarteaucitron redevient utile.
11 / 11










