# Oublié cinq ans dans les styles globaux : ce qu’un audit révèle d’un token

> Un token de couleur créé à l'origine d'un theme.json, jamais renommé ni retiré depuis. Ce qu'un audit sur un projet ancien apprend sur la longévité réelle d'une gouvernance par design tokens.

- Auteur : Clément Hadrot
- Publié le : 2026-08-31
- Mis à jour le : 2026-08-31
- Catégorie : FSE
- URL : https://wpmoderne.dev.wordpress-developpement.fr/fse/oublie-cinq-ans-styles-globaux-audit-token/

## L’essentiel

- Un token créé en 2021 peut encore porter le nom d'un choix de design abandonné depuis
- Le vrai test de gouvernance n'est pas la création, c'est la capacité à retirer
- Un token orphelin coûte peu seul, mais s'accumule silencieusement

« bleu-campagne-2021 » : ce slug de couleur, retrouvé lors d'un audit récent dans le fichier `theme.json` d'un projet actif depuis l'arrivée de `theme.json` en version stable, n'a plus aucun rapport avec la palette actuellement utilisée sur le site. La couleur qu'il désigne a été remplacée depuis longtemps par une nouvelle charte graphique, mais le token, lui, n'a jamais été retiré — simplement laissé de côté, invisible pour quiconque ne va pas chercher directement dans le fichier source.

Ce cas illustre une question plus large que celle d'une seule couleur oubliée : que devient réellement une gouvernance de styles globaux sur cinq ans, une fois passées les phases d'enthousiasme initial et les premières refontes de charte graphique ?

## Ce que l'audit a trouvé

Le projet en question a démarré peu après la stabilisation de `theme.json` en juillet 2021, avec une palette de couleurs pensée pour une campagne de communication ponctuelle. Cette campagne s'est terminée depuis longtemps, la charte graphique du site a changé au moins deux fois depuis, mais le token de couleur original est resté déclaré dans les préréglages, sans être supprimé ni renommé.

Techniquement, ce token ne pose aucun problème visible : s'il n'est plus référencé par aucun style de bloc, il n'a aucun effet sur l'affichage du site. C'est justement cette absence d'effet visible qui explique sa survie silencieuse — personne n'a de raison de le remarquer tant qu'il ne casse rien.

## Pourquoi un token orphelin s'accumule plutôt que de disparaître

> L'essentiel à retenir : Un token créé en 2021 peut encore porter le nom d'un choix de design abandonné depuis ; Le vrai test de gouvernance n'est pas la création, c'est la capacité à retirer ; Un token orphelin coûte peu seul, mais s'accumule silencieusement

Trois raisons expliquent cette accumulation, observées de façon récurrente sur les projets anciens audités :

- Retirer un token demande de vérifier au préalable qu'aucun bloc, aucun pattern, aucune variation de style ne le référence encore — une vérification plus coûteuse en temps que le simple fait de l'ajouter.
- La personne qui a créé le token a souvent quitté le projet ou l'équipe au moment où il devient obsolète, ce qui laisse ce nettoyage sans propriétaire naturel.
- Un token inutilisé ne génère aucune alerte, aucun message d'erreur : rien dans le fonctionnement normal du site ne signale sa présence comme un problème à traiter.

## Comment repérer les tokens réellement orphelins

La méthode la plus fiable reste une recherche textuelle du slug du token dans l'ensemble des fichiers du thème et dans le contenu des gabarits enregistrés en base, plutôt qu'une simple lecture du fichier `theme.json` :

```
wp db query "SELECT ID, post_title FROM wp_posts WHERE post_content LIKE '%bleu-campagne-2021%' AND post_type IN ('wp_template', 'wp_template_part', 'wp_block')"
```

Une recherche complémentaire dans les fichiers de patterns et de gabarits du thème, avec un outil de recherche de texte classique sur le dossier du projet, complète ce contrôle pour les usages déclarés directement en fichiers plutôt qu'en base.

## Ce que révèle vraiment cet audit

Le vrai enseignement ne porte pas sur ce token précis, facilement supprimé une fois identifié, mais sur ce qu'il indique : la gouvernance des styles globaux d'un projet est solide au moment de sa création, mais rarement entretenue dans la durée sans un processus explicite de revue périodique. Créer un token propre est une discipline suivie presque partout ; retirer un token devenu obsolète est une discipline suivie presque nulle part, faute de déclencheur naturel qui la rappelle.

### Une piste pour rompre ce schéma

Associer chaque refonte de charte graphique à une revue explicite des préréglages existants, plutôt que de se contenter d'ajouter les nouveaux tokens à côté des anciens, romprait ce schéma d'accumulation. Cette étape demande peu de temps comparée à la refonte elle-même, mais elle est presque systématiquement oubliée, la priorité allant naturellement à ce qui se voit plutôt qu'à ce qui se nettoie.

> Le constat qu'on tire de cet audit, applicable à tout projet ancien : un token de design ne coûte rien tant qu'il est seul, mais un theme.json qui accumule ce genre d'oubli pendant cinq ans devient, sans qu'on l'ait décidé, un historique complet et non documenté de toutes les chartes graphiques passées du projet.

## En résumé

Un token oublié cinq ans dans les styles globaux n'est jamais un problème technique en soi : c'est le symptôme d'une gouvernance qui a bien géré la création, mais jamais organisé le retrait. Sur un projet destiné à durer, la revue périodique des préréglages mérite une place aussi régulière que celle accordée à leur création initiale.
