Le balisage schema sur les sites Webflow CMS : leçons de quatre projets clients
Un JSON-LD construit à partir des champs du CMS échoue rarement de façon visible. Il se lit, le validateur reste vert, et les valeurs sont fausses. Où vit le balisage sur quatre sites clients, cinq façons dont il a cassé, et les contrôles qui l’ont détecté.
Entre juillet et novembre 2026, j’ai refait ou audité le JSON-LD de quatre sites Webflow CMS : Carda
Health, Oceans, Growthopia et
ProfitPad. Un balisage généré à partir des champs du CMS échoue rarement de façon visible. Il
se lit, le validateur reste vert, et les valeurs qu’il contient sont fausses : un auteur vide, une date prise dans un
autre champ, une apostrophe servie sous la forme '. Voici où vit le balisage sur ces sites, ce qui a cassé, et
les contrôles qui l’ont détecté.
Deux changements de Google cadrent ce travail. Les résultats enrichis FAQ n’apparaissent plus dans la recherche Google depuis le 7 mai 2026, selon le journal des modifications de Search Central : le balisage FAQ n’est donc plus un levier de résultat enrichi. Et le guide d’optimisation pour l’IA de Google (mai 2026) précise que les données structurées ne sont pas nécessaires pour ses fonctionnalités d’IA générative, tout en restant utiles pour être éligible aux résultats enrichis. Ce que le JSON-LD doit faire, c’est décrire l’entreprise et ses pages avec exactitude. L’exactitude, c’est tout le travail.
Où vit le JSON-LD
Chaque type de nœud a sa place :
- Le code d’en-tête du site contient Organization et WebSite, une seule fois. Sur Growthopia, c’est un seul
@graphdans le code d’en-tête du site, et le fichier du dépôt du projet fait foi. Sur un autre site, le même bloc est identique à l’octet près sur toutes les pages. - Le modèle CMS construit les nœuds de page (BlogPosting ou Article, WebPage, BreadcrumbList) à partir des champs du CMS. Un site utilise le champ de balisage schema des Page Settings de chaque modèle, avec des jetons de champ ; Carda utilise un Code Embed sur le modèle, avec des champs liés.
- Un champ de texte riche par élément contient les blocs FAQ : deux des sites stockent le FAQPage de
chaque élément sous forme de bloc
ld+jsondans un champ de texte riche. - Un JSON-LD écrit à la main couvre les pages uniques, comme la page principale du programme de Carda.
Une règle tient l’ensemble : un seul @graph par page, et chaque page fait référence aux nœuds #organization et
#website du site par leur @id au lieu de les déclarer de nouveau. Le provider d’un Service ou le publisher
d’un article est une référence, pas une copie.
Une limite pratique : l’API de Webflow n’a été d’aucune aide pour écrire le balisage sur ces projets. Sur deux des sites, le point
d’accès du schéma répondait 403, et l’appel des réglages de page annonçait un succès sans rien
enregistrer. Le balisage des modèles a
été collé à la main dans le Designer. Je garde donc chaque bloc dans le dépôt du projet et je compare la page servie
avec lui après chaque collage ; sur un site, les blocs collés ont été comparés octet
par octet le 3 novembre 2026. Un autre piège dans ce
champ : collez du JSON brut ou la balise complète <script type="application/ld+json">. Une balise <script> seule
est servie comme du JavaScript.
Cinq façons dont les champs liés cassent le balisage
1. Les caractères sortent échappés. Une apostrophe droite dans un champ du CMS lié au JSON-LD est servie sous la
forme ', et une esperluette sous la forme &. Dans un bloc
<script>, ces entités ne sont pas décodées : un nom comme O'Neill devient O'Neill dans le balisage. La
lecture réussit quand même, donc les validateurs restent verts. L’audit d’un site, en octobre 2026, a trouvé '
21 fois sur 13 pages et & 12 fois sur 8. La correction consiste à mettre des
apostrophes typographiques dans les champs du CMS eux-mêmes.
2. Un champ supprimé laisse une valeur vide. Supprimer ou remplacer un champ du CMS vide chaque liaison qui
l’utilisait, sans avertissement dans le Designer ni erreur à la publication. Sur un site, remplacer un auteur en
texte simple par un champ de référence a laissé des articles avec "author":{"@type":"Person","name":""} : du JSON
valide, sans personne dedans. Sur un autre, l’image de l’auteur dans le balisage de 66 articles était liée à un champ
qui n’existait plus. Ma règle désormais : publier sur l’environnement de test, comparer le JSON-LD à celui de la
production, et garder l’ancien champ jusqu’à ce que la nouvelle liaison soit vérifiée en ligne.
3. Les dates viennent du mauvais champ. Liez datePublished au champ Published On de Webflow, et la date change
à chaque republication d’un élément modifié : une mise à jour groupée redate toutes les archives. Sur un site, un article
affichait le 29 avril sur la page et le 18 juin dans son balisage. Sur un autre site, la date du balisage et la date
visible
de la signature venaient de deux champs différents et divergeaient sur 24 des 66 articles. Je lie datePublished au
champ qu’affiche la signature, je garde dateModified sur Updated On, et je règle le format de date sur
YYYY-MM-DD dans l’embed. La date du balisage et la date visible peuvent aussi différer d’un jour : le balisage est
rendu en UTC, la page dans le fuseau horaire du site, et c’est le même instant.
4. Du texte libre atterrit dans des propriétés typées. Certaines propriétés de schema.org attendent un format
précis. Sur un site, un champ libre de temps de lecture produisait timeRequired: "PT7 minM" sur 72 pages, et la
propriété a été retirée. Sur Carda, les réponses de la FAQ étaient placées dans une chaîne de script : un seul
guillemet droit dans une réponse cassait tout le FAQPage.
5. Les champs vides émettent quand même la propriété. Une liaison s’affiche que le champ ait une valeur ou non.
Sur Carda, les articles sans auteur émettaient un auteur au nom vide, et les articles sans relecteur médical un
reviewedBy vide. Laissez les nœuds facultatifs hors du modèle, ou placez-les dans un embed qui ne s’affiche que si
le champ est rempli.
Le balisage FAQ s’éloigne de la page
Les règles de Google sur les données structurées sont claires : ne balisez pas un contenu que les lecteurs ne voient pas. Le balisage FAQ est le plus facile à casser de cette façon, parce que la FAQ est modifiée sur la page et pas la copie dans le JSON-LD. Avant les corrections, l’exploration d’un site a trouvé 127 questions du balisage, sur 32 pages, qui ne correspondaient pas au texte visible, et deux pages d’atterrissage où aucune des 5 questions du balisage n’apparaissait. Après les corrections, ses 80 blocs FAQ correspondaient à la page (22 octobre 2026). Sur un autre site, le balisage FAQ d’une page a gardé une ancienne affirmation après la modification du texte de la page, et le contrôle des FAQ l’a signalé jusqu’au collage du bloc corrigé, le 3 novembre 2026.
Sans résultats enrichis FAQ, l’intérêt du balisage FAQ est moindre qu’avant. Là où il reste, il lui faut un contrôle qui le compare à la page, parce que deux copies finissent par diverger.
Comment je le contrôle
- Lire la page en ligne, pas le rapport du validateur. Le test des résultats enrichis ne rapporte que les types
qui peuvent obtenir un résultat enrichi : les nœuds WebSite et ItemList n’y apparaissent pas. Je récupère le HTML
servi et je lis chaque bloc
ld+json. - Récupérer la page brute. Un outil qui retire les balises
<script>ne voit jamais le JSON-LD ; j’utilise curl avec l’agent utilisateur d’un navigateur. Quand un script injecte une partie du balisage, contrôlez aussi la page rendue. - Explorer tout le sitemap. Sur un site, le contrôle couvrait chaque URL du sitemap :
@ideturlabsolus, dates ISO, aucun jeton de champ{{wfrestant, et chaque question et réponse de la FAQ présente dans le texte visible après normalisation des guillemets, des tirets et des espaces. - L’environnement de test d’abord. Publier sur l’environnement de test et comparer le JSON-LD à celui de la production avant la mise en ligne.
- Continuer à surveiller. Les régressions du JSON-LD font partie des contrôles du moniteur que j’ai conçu pour les sites clients.
Ce que ça a donné
- Carda : balisage v2 en ligne le 22 octobre 2026, vérifié sur les 67 articles récents, plus un BlogPosting réécrit et vérifié sur les 102 articles de l’ancien design.
- Oceans : 124 URL du sitemap explorées de nouveau le même jour : toutes répondaient 200, chaque bloc se lisait, aucun jeton restant, et 80 blocs FAQ sur 80 correspondaient à la page.
- Growthopia : un graphe Organization et WebSite sur tout le site, en ligne depuis le 12 août 2026, avec le
profil Trustpilot lié par
sameAsplutôt qu’une note dans le balisage. Les consignes de Google sur les extraits d’avis rendent les pages d’une organisation inéligibles aux étoiles d’avis quand elle contrôle les avis qui la concernent, widgets tiers intégrés compris. - ProfitPad : unification des FAQ publiée le 3 novembre 2026 sur 9 pages, sans aucune alerte FAQ sur les 37 pages que couvrait le contrôle.
Rien de tout cela n’est visible pour un visiteur, et Google dit que rien de tout cela n’est nécessaire pour apparaître dans ses fonctionnalités d’IA. C’est pourtant là que « valide » et « juste » se séparent sur un site Webflow, sans que personne ne le remarque.
Mon audit SEO gratuit contrôle sur-le-champ le JSON-LD d’une page d’accueil : s’il se lit, et s’il déclare une Organization, une Person ou un type proche pour l’entreprise.
Ce qui manque à votre site
Commencez par un audit gratuit de votre site, vérifié par moi. Ou réservez trente minutes, votre projet à l’écran : vous repartez avec un plan cadré et un chiffre, que nous travaillions ensemble ou non.
