![Guide Contentful CMS : Fonctionnalités, Tarifs, API GraphQL & Exemples de Code [2026]](/_next/image?url=https%3A%2F%2Fmedia.techsy.io%2Ftechsy-io%2Fhero-106-1200x630.webp&w=3840&q=75)
Contentful est un headless CMS API-first qui stocke votre contenu dans un hub centralisé et le délivre via des API REST et GraphQL vers n'importe quel frontend — web, mobile, IoT, affichage numérique, peu importe ce que vous construisez. Ce guide couvre tout ce que les autres passent sous silence : de vrais exemples de code, des tarifs réels et des limites honnêtes.
Nous utilisons Sanity (un concurrent direct de Contentful) en production sur quatre sites et dix langues, donc nous abordons le sujet en praticiens, pas comme des revendeurs.
Résumé rapide
| Détail | Info |
|---|---|
| Type | Headless CMS (API-first) |
| Fondé | 2013, Berlin |
| Idéal pour | Équipes enterprise, contenu multicanal, projets à forte localisation |
| Pas idéal pour | Développeurs solo avec budget serré, blogs simples, équipes cherchant de l'édition visuelle dès le départ |
| Niveau gratuit | Oui — 10 utilisateurs, 100K appels API/mois, 1 espace |
| Plans payants | À partir de $300/mois (Lite) jusqu'à Enterprise sur devis |
| APIs | REST (CDA, CMA, CPA) + GraphQL |
| Modélisation de contenu | Structurée : types de contenu, champs, références, validations |
| Fonctionnalités IA | AI Actions, Contentful Studio, personnalisation Ninetailed |
| Localisation | Support natif des locales, pas de gestion des traductions intégrée |
| Open Source | Non |
| Principaux concurrents | Sanity, Strapi, Storyblok, Payload, Hygraph |
Qu'est-ce que Contentful ?
Contentful est un headless CMS cloud-native et API-first — ou comme l'entreprise le nomme désormais, une "plateforme de contenu composable". Contrairement aux systèmes traditionnels comme WordPress qui associent la gestion de contenu à un frontend, Contentful stocke le contenu structuré de façon centralisée et le délivre via des API vers n'importe quel canal.
Le concept clé, c'est l'architecture découplée. Votre contenu vit dans le cloud de Contentful. Votre frontend — qu'il s'agisse d'un site Next.js, d'une application React Native ou d'un écran connecté — récupère ce contenu via les API de Contentful au moment du build ou à l'exécution. Le contenu ne sait pas et ne se préoccupe pas de l'endroit où il finit.
Fondé à Berlin en 2013, Contentful est devenu l'un des plus grands fournisseurs de headless CMS. Des marques comme Spotify, Vodafone, Chanel et Atlassian font tourner leurs opérations de contenu dessus. Ce n'est pas open source et il n'y a pas d'option d'hébergement propre — c'est du SaaS uniquement, ce qui compte si vous avez des contraintes de conformité liées à la résidence des données.
Selon la documentation officielle de Contentful, la plateforme se positionne comme une infrastructure pour le contenu — un hub qui s'intercale entre votre équipe éditoriale et vos expériences numériques.
Comment fonctionne Contentful ?
Contentful suit une architecture en trois couches : vous définissez votre Modèle de Contenu (le schéma), vous créez du Contenu (les entrées), puis vous le délivrez via des API. Le contenu est agnostique du canal — le même article de blog peut alimenter votre site web, votre application mobile et votre newsletter sans aucune duplication.
Tout passe par les API. Il n'y a pas de rendu côté serveur intégré, pas de templates, pas de couche thème. Vous construisez le frontend comme bon vous semble, et Contentful gère le stockage et la livraison du contenu.
Les trois APIs
Contentful vous donne trois APIs distinctes, chacune avec son propre rôle et son authentification :
- Content Delivery API (CDA) : Accès en lecture seule au contenu publié. Adossée au CDN de Fastly, donc les requêtes mises en cache sont rapides et illimitées. Les requêtes non mises en cache sont limitées à 55 par seconde.
- Content Management API (CMA) : Accès en lecture-écriture pour créer et mettre à jour du contenu par programmation. Limitée à 10 requêtes par seconde. C'est ce que vous utiliseriez pour les migrations, les imports en masse ou les pipelines CI/CD.
- Content Preview API (CPA) : Identique à la CDA mais sert le contenu brouillon. Parfait pour créer des modes de prévisualisation dans votre frontend — les éditeurs voient les modifications non publiées avant de cliquer sur publier.
Les trois supportent REST et GraphQL. L'authentification se fait via des tokens Bearer, avec des tokens séparés pour la livraison et la gestion.
Environnements et Spaces
Pensez aux Spaces comme des projets et aux Environnements comme des branches git pour votre contenu. Vous pourriez avoir un environnement master pour la production et un environnement staging où les éditeurs peuvent travailler sans affecter le contenu en ligne.
Les environnements supportent les alias — vous pouvez pointer l'alias master vers un nouvel environnement pour des promotions de contenu sans interruption de service. Si vous choisissez un framework frontend à associer à Contentful, ce modèle d'environnement fonctionne bien avec les déploiements de prévisualisation sur des plateformes comme Vercel ou Netlify.
Les webhooks vous permettent de déclencher des builds, de synchroniser avec des systèmes externes ou de lancer des workflows à chaque changement de contenu. La plupart des équipes les connectent à leur pipeline CI/CD pour reconstruire leur site statique à chaque événement de publication.
La modélisation de contenu dans Contentful
La modélisation de contenu consiste à définir la structure de votre contenu — le "schéma" qui détermine quels champs existent, quels types de données ils contiennent et comment les types de contenu se relient entre eux. D'après notre expérience, c'est là que Contentful brille vraiment par rapport aux options CMS plus simples.
Vous concevez essentiellement un schéma de contenu, similaire aux tables d'une base de données mais plus flexible. Un type de contenu "Article de blog" pourrait avoir un titre (texte court), un corps (texte riche), un auteur (référence vers un type de contenu Auteur) et des tags (tableau de chaînes de caractères). Chaque entrée que vous créez suit cette structure.
Types de champs et validations
Contentful propose une gamme solide de types de champs :
- Texte court (Symbol) : Titres, slugs, libellés — jusqu'à 256 caractères
- Texte long (Text) : Markdown ou texte brut, sans limite de caractères
- Texte riche : Basé sur JSON (pas HTML), vous donne un contrôle total sur le rendu
- Nombre : Entier ou décimal
- Date/Heure : Format ISO 8601
- Booléen : Bascules vrai/faux
- Média (Asset) : Images, vidéos, documents — stockés dans le pipeline d'assets de Contentful
- Référence (Link) : Connecte des entrées à d'autres entrées ou assets
- Objet JSON : Données structurées libres
- Localisation : Paires latitude/longitude
Chaque champ supporte des validations : requis, unique, expressions régulières, limites de taille et messages de validation personnalisés. Vous pouvez également définir des options d'apparence qui contrôlent comment le champ s'affiche dans l'interface de l'éditeur.
Références et entrées liées
Les références permettent de connecter des types de contenu. Une référence "Auteur" sur un Article de blog pointe vers une entrée Auteur. Un champ "Articles connexes" peut référencer plusieurs entrées d'articles. Cela crée un graphe de contenu — des entrées liées à d'autres entrées, interrogeables en un seul appel API.
Voici à quoi ressemble réellement la définition d'un type de contenu Article de blog quand vous le créez via la Content Management API :
{
"name": "Blog Post",
"fields": [
{ "id": "title", "type": "Symbol", "required": true },
{ "id": "slug", "type": "Symbol", "validations": [{ "unique": true }] },
{ "id": "body", "type": "RichText" },
{ "id": "author", "type": "Link", "linkType": "Entry" },
{ "id": "publishDate", "type": "Date" },
{ "id": "tags", "type": "Array", "items": { "type": "Symbol" } }
]
}C'est le genre de chose que vous stockeriez dans un dépôt de contrôle de version et appliqueriez via des scripts de migration. Aucun concurrent ne montre ça dans ses guides Contentful — ils parlent de modélisation de contenu de façon abstraite sans montrer ce que ça donne vraiment en code.
Interroger le contenu : APIs REST et GraphQL
Contentful fournit des APIs REST et GraphQL pour récupérer du contenu. REST est simple pour les requêtes basiques. GraphQL est plus adapté quand vous avez besoin de données imbriquées, de plusieurs types de contenu en une seule requête, ou que vous voulez éviter la sur-récupération. Les deux utilisent les mêmes tokens d'authentification.
L'endpoint GraphQL est auto-généré à partir de votre modèle de contenu. Chaque type de contenu que vous créez devient un type interrogeable dans le schéma, avec filtrage, tri et pagination intégrés. L'endpoint se trouve à :
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}Selon la documentation GraphQL de Contentful, le schéma se met à jour automatiquement dès que vous modifiez vos types de contenu — pas de gestion manuelle du schéma requise.
Exemples de requêtes GraphQL
Voici une requête simple pour récupérer vos dix articles de blog les plus récents avec leurs auteurs :
query {
blogPostCollection(limit: 10, order: publishDate_DESC) {
items {
title
slug
publishDate
author {
name
}
}
}
}Besoin de filtrer par tag et de récupérer du contenu en allemand ? Ajoutez une clause where et un paramètre locale :
query {
blogPostCollection(
where: { tags_contains_some: ["javascript"] }
locale: "de"
) {
items {
title
body {
json
}
}
}
}Un point d'attention : les requêtes GraphQL ont des limites de complexité. Les requêtes profondément imbriquées avec plusieurs références liées peuvent atteindre le plafond. Contentful calcule la complexité en fonction du nombre de nœuds et de la profondeur de la requête. Si vous récupérez des articles de blog avec leurs auteurs, catégories, articles connexes et l'auteur de chaque article connexe — ça s'accumule vite.
Les bases de l'API REST
L'API REST est plus simple mais nécessite davantage de requêtes pour les données imbriquées. Une récupération basique des articles de blog appelle https://cdn.contentful.com/spaces/{SPACE_ID}/entries?content_type=blogPost. Vous obtenez du JSON avec un tableau items plat et un objet includes séparé pour les entrées liées que vous devrez résoudre côté client.
Si vous travaillez avec TypeScript, le SDK contentful.js de Contentful gère la résolution des liens et la génération de types automatiquement. Pour des appels fetch bruts, voici le JavaScript minimal pour interroger l'API GraphQL :
const response = await fetch(
`https://graphql.contentful.com/content/v1/spaces/${SPACE_ID}`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${CDA_TOKEN}`,
},
body: JSON.stringify({ query }),
}
);
const { data } = await response.json();C'est tout. Pas de SDK requis, pas d'étape de build, pas de dépendances. Ça fonctionne dans Node.js, Deno, Cloudflare Workers, le navigateur — partout où vous pouvez faire des requêtes HTTP.
Fonctionnalités clés à connaître
Contentful embarque un large ensemble de fonctionnalités, mais toutes n'ont pas le même impact. Voici celles qui affectent vraiment votre expérience au quotidien et vos décisions d'architecture.
Localisation (points forts et lacunes)
Le modèle de localisation de Contentful est solide au niveau de l'infrastructure. Vous définissez des locales pour votre espace (plus de 100 sur les plans Enterprise), et chaque champ peut stocker des valeurs par locale. Les remplacements de locale au niveau du champ signifient que votre titre allemand peut différer de l'anglais tout en partageant la même image hero.
La lacune, c'est la gestion des traductions. Contentful vous donne les champs pour stocker les traductions, mais pas le workflow pour les produire. Pas de mémoire de traduction, pas de glossaire, pas de système d'attribution, pas de suivi de progression. Vous avez besoin d'une intégration tierce — Phrase, Smartcat ou Lokalise — pour gérer le vrai processus de traduction. Pour les équipes gérant 10+ langues (nous en gérons 10 sur nos sites), cette lacune devient vite coûteuse.
Environnements et branches
Les environnements fonctionnent comme des branches git pour votre modèle de contenu et vos entrées. Créez un environnement staging, apportez des modifications au schéma, testez avec du contenu, puis promouvez vers master quand vous êtes prêt. Les alias vous permettent de switcher l'environnement vers lequel master pointe sans changer les URLs des API.
C'est vraiment utile pour les migrations de schéma. Vous pouvez tester un nouveau type de contenu dans un environnement isolé, vérifier que le frontend le gère correctement, puis promouvoir — le tout sans toucher au contenu de production. La plupart des équipes que nous avons vues utilisent deux ou trois environnements : production, staging et parfois une branche pour les migrations importantes.
Autres fonctionnalités à mentionner :
- Rôles et permissions : Contrôle d'accès granulaire — limitez les éditeurs à des types de contenu spécifiques, bloquez l'accès à la publication pour les rôles juniors, rôles personnalisés sur les plans Enterprise, SSO
- Webhooks : Déclenchez des builds, des notifications Slack ou des workflows externes sur n'importe quel événement de contenu
- Texte riche : Basé sur JSON, offrant un contrôle total sur le rendu mais nécessitant des rendus personnalisés pour chaque framework frontend
- App Framework : Marketplace avec des extensions pour les éditeurs de champs personnalisés, les widgets de barre latérale et les intégrations
- Image API : Redimensionnement, recadrage, conversion de format à la volée (WebP, AVIF) et recadrage par point focal — pas besoin de CDN d'images séparé
Les nouveautés de Contentful en 2026
Contentful a livré des mises à jour significatives tout au long de 2025 et au début de 2026, et aucun guide concurrent n'en parle. Si vous évaluez Contentful sur la base d'informations de 2023 ou 2024, vous travaillez avec un tableau incomplet.
AI Actions et automatisation du contenu
Contentful a lancé les AI Actions — des workflows de contenu automatisés alimentés par des grands modèles de langage directement dans l'éditeur. Ils gèrent les brouillons de traduction, la génération de métadonnées SEO, la rédaction de textes alternatifs, les ajustements de ton et les résumés de contenu. Vous y accédez depuis la barre latérale de l'éditeur, et ils opèrent sur l'entrée que vous modifiez actuellement.
Selon la couverture de Diginomica, les AI Actions font partie de la démarche plus large de Contentful pour se positionner en tant que plateforme d'expérience digitale complète (DXP), pas seulement un headless CMS. La fonctionnalité est vraiment utile pour automatiser les tâches éditoriales répétitives, même si le résultat de traduction nécessite encore une relecture humaine — c'est un premier jet, pas un produit fini.
Contentful Studio (constructeur visuel)
Contentful Studio est passé en disponibilité générale au printemps 2024 et a bien mûri tout au long de 2025. C'est un constructeur de pages visuelles qui permet aux non-développeurs de composer des pages avec des composants en glisser-déposer et un aperçu en direct. Si vous avez entendu la critique "Contentful n'a pas d'édition visuelle" — Studio est la réponse, avec quelques nuances toutefois.
Studio nécessite une intégration frontend (vos composants doivent être enregistrés avec le SDK de Studio), et c'est un module complémentaire payant, non inclus dans les plans de base. Pour les équipes qui réclamaient un constructeur de pages à la WordPress sur le modèle de contenu structuré de Contentful, c'est désormais une vraie option. Storyblok a encore l'avantage pour les workflows visuels en premier, mais l'écart se réduit.
Personnalisation avec Ninetailed
Contentful a acquis Ninetailed en 2024 et l'a rebrandé en Contentful Personalization. Comme CMS Critic le rapporte, cela vous donne des tests A/B natifs, une segmentation d'audience et des suggestions de variantes pilotées par l'IA — le tout accessible depuis un onglet Optimization dans l'éditeur.
C'est notable parce que la personnalisation nécessitait historiquement un fournisseur séparé (Optimizely, Dynamic Yield, etc.). L'avoir intégré au CMS réduit la complexité d'intégration. La nuance : Ninetailed est un produit séparé avec sa propre tarification. Ce n'est pas "gratuit avec Contentful."
Tarifs Contentful : Ce que ça coûte vraiment
Contentful propose quatre niveaux, mais la plupart des guides concurrents se contentent de les nommer sans donner les vrais chiffres. Voici ce à quoi vous pouvez vous attendre en avril 2026, d'après la page de tarifs de Contentful :
| Plan | Prix | Utilisateurs | Appels API/mois | Bande passante CDN | Espaces |
|---|---|---|---|---|---|
| Gratuit (Community) | $0 | 10 | 100K | 50 Go | 1 Starter |
| Lite | $300/mois | 20 | 1M | 100 Go | Multiple |
| Premium | Sur devis (~$2K+/mois) | Illimité | Illimité | Personnalisé | Personnalisé |
| Enterprise | Sur devis (5 à 6 chiffres/an) | Illimité | Illimité | Personnalisé | Personnalisé |
"Coût mensuel Contentful par niveau"
Tableau de données
| "Plan" | "Coût mensuel" |
|---|---|
| "Gratuit" | 0 |
| "Lite" | 300 |
| "Premium" | 2000 |
| "Enterprise" | 5000 |
Le niveau gratuit est généreux pour le prototypage et l'apprentissage. Vous obtenez 10 utilisateurs, 100K appels API et assez de bande passante pour construire un vrai projet. Mais les coûts escaladent vite dès que vous en sortez.
Coûts cachés à prévoir :
- Dépassements d'API sur Lite : Dépassez 1M d'appels/mois et vous verrez des postes de dépassement sur votre facture
- Coûts des locales : Chaque locale supplémentaire compte dans les limites de votre espace — 50 locales au niveau du champ, ça s'accumule
- Contentful Studio : Le constructeur visuel est un module complémentaire payant, non inclus dans Lite ni dans certains plans Premium
- Personnalisation Ninetailed : Produit séparé, contrat séparé, tarification séparée
- Services professionnels : L'aide à la migration, l'onboarding et la formation sont facturés séparément
- Rendus de texte riche : Pas un coût direct, mais le temps de développement pour construire des rendus personnalisés pour votre framework est bien réel
Notre avis honnête : Le niveau gratuit de Contentful est solide pour l'évaluation et les petits projets. Mais si le budget est une contrainte principale, les alternatives CMS open source comme Strapi ou Payload éliminent complètement les coûts de licence — vous ne payez que l'hébergement.
Contentful vs Sanity vs Strapi : Comparaison honnête
Ce sont les trois options de headless CMS qui reviennent dans presque toutes les évaluations. Nous avons construit des systèmes en production sur Sanity, donc nous en connaissons les forces et faiblesses de première main. Voici une comparaison honnête :
| Fonctionnalité | Contentful | Sanity | Strapi |
|---|---|---|---|
| Type | SaaS (source fermée) | SaaS + auto-hébergé | Open source (auto-hébergé ou Cloud) |
| Niveau gratuit | 10 utilisateurs, 100K appels | 100K appels API, 3 utilisateurs | Illimité (auto-hébergé) |
| GraphQL | Natif | Plugin (GROQ est primaire) | Natif |
| Modélisation de contenu | Interface + API | Code (schéma en code) | Interface + code |
| Collaboration temps réel | Oui | Oui (Presence API) | Limitée |
| Édition visuelle | Studio (module complémentaire) | Visual Editing (natif) | Non |
| Localisation | Locales natives | Plugin/personnalisé | Plugin (i18n) |
| Tarifs | À partir de $300/mois | À partir de $0 (niveau gratuit généreux) | Gratuit (auto-hébergé) |
| Idéal pour | Enterprise, multicanal | Développeurs-first, schémas flexibles | Budget réduit, auto-hébergé |
Contentful gagne pour les équipes enterprise avec de grandes opérations de contenu et des besoins stricts en gouvernance. Le système de rôles mature, le SSO, les journaux d'audit et la SLA à 99,99% sur les plans Enterprise sont difficiles à égaler.
Sanity gagne pour l'expérience développeur et la flexibilité du schéma. Si vous préférez le schéma en code, voulez la puissance de requête de GROQ, et appréciez les fonctionnalités de collaboration en temps réel, Sanity est le meilleur choix. Lisez notre guide complet Sanity CMS pour aller plus loin.
Strapi gagne sur le coût. C'est gratuit à auto-héberger sans limites d'appels API. Si vous avez les capacités DevOps pour gérer votre propre infrastructure et n'avez pas besoin d'un support enterprise, Strapi vous donne le plus de CMS par euro.
Pour une comparaison plus large incluant Storyblok, Payload et Hygraph, consultez notre comparaison complète des headless CMS.
Limitations à connaître avant de choisir Contentful
Tout CMS implique des compromis. Voici ceux de Contentful — avec des chiffres précis, pas des généralités vagues. Nous en avons rencontré plusieurs lors de l'évaluation de Contentful pour notre propre pipeline de contenu.
Les limites de taux sont réelles. La CDA autorise 55 requêtes non mises en cache par seconde. Les réponses en cache CDN sont illimitées, mais si votre application contourne le cache (rendu côté serveur à chaque requête, par exemple), vous atteindrez les limites vite. La CMA est encore plus stricte à 10 requêtes par seconde — ce qui compte pour les scripts de migration et les imports en masse.
Pas d'édition visuelle intégrée (sans payer en plus). Contentful Studio existe, mais c'est un module complémentaire payant qui nécessite une intégration frontend. Si votre équipe s'attend à un constructeur de pages à la WordPress dans le produit de base, préparez-vous à cette conversation. Storyblok inclut l'édition visuelle à tous les niveaux.
Pas de gestion des traductions. Vous obtenez des champs de locale — c'est tout. Pas de workflows de traduction, pas de système d'attribution, pas de mémoire de traduction, pas de suivi de progression. Pour une plateforme qui vend la localisation comme fonctionnalité clé, l'expérience de traduction réelle repose entièrement sur des outils tiers comme Phrase, Smartcat ou Lokalise.
Dépendance au développeur pour tout ce qui touche au frontend. Les éditeurs de contenu peuvent créer et gérer des entrées. Ils ne peuvent pas modifier les mises en page, ajouter de nouvelles sections, modifier la navigation ou mettre à jour le frontend de quelque manière que ce soit sans un développeur. C'est inhérent à l'architecture headless, mais amplifié dans Contentful parce que le produit de base n'inclut pas de constructeur de pages.
La tarification devient imprévisible à l'échelle. Les dépassements d'appels API, les limites basées sur les locales, les coûts supplémentaires pour Studio et la Personnalisation, et les services professionnels créent un modèle de tarification difficile à prévoir. Plusieurs équipes avec qui nous avons parlé ont été surprises par leur première facture après le niveau gratuit.
La complexité du texte riche. Le texte riche de Contentful est basé sur JSON, pas HTML. Chaque framework frontend a besoin d'un rendu personnalisé — @contentful/rich-text-react-renderer pour React, rich-text-html-renderer pour le JS vanilla, etc. Ça vous donne un contrôle total sur le rendu, mais c'est significativement plus de travail de développement que les concurrents basés sur HTML.
Dépendance fournisseur. Source fermée, SaaS uniquement, pas d'option d'auto-hébergement. Votre contenu est exportable via API, mais votre modèle de contenu, vos workflows et vos intégrations sont spécifiques à Contentful. Si les tarifs changent ou si des fonctionnalités sont dépréciées, vos options sont limitées.
Qui devrait (et ne devrait pas) utiliser Contentful
Contentful est une plateforme solide, mais ce n'est pas le bon choix pour tous les projets. Voici un cadre de décision pour vous aider à vous situer.
Utilisez Contentful si :
- Vous êtes une équipe enterprise gérant du contenu sur plusieurs canaux (web, mobile, IoT, affichage numérique)
- Vous avez besoin d'une localisation native avec 50+ locales et des remplacements au niveau du champ
- Vous voulez une plateforme mature et éprouvée avec un support dédié et une SLA à 99,99%
- Votre équipe comprend des développeurs à l'aise avec l'architecture API-first
- Vous avez besoin de rôles granulaires, de permissions, de journaux d'audit et de SSO
Évitez Contentful si :
- Vous êtes un développeur solo ou une petite équipe avec des contraintes budgétaires — regardez du côté de Strapi ou Payload
- Vous voulez un constructeur de pages visuel inclus dans le produit de base — regardez du côté de Storyblok
- Vous préférez des définitions de schéma code-first et une flexibilité maximale — regardez du côté de Sanity
- Vous avez besoin d'un simple CMS de blog — WordPress ou Ghost est moins cher et plus rapide à mettre en place
- Vous voulez vous auto-héberger pour des raisons de conformité — regardez du côté de Strapi ou Payload
| Si vous avez besoin de... | Choisissez | Parce que |
|---|---|---|
| Gouvernance de niveau enterprise | Contentful | Rôles matures, SSO, journaux d'audit, SLA à 99,99% |
| Flexibilité développeur maximale | Sanity | Schéma en code, GROQ, portable text |
| Zéro coût de licence | Strapi ou Payload | Open source, auto-hébergeable |
| Édition visuelle dès le départ | Storyblok | L'éditeur visuel est le produit principal |
| Blog simple | WordPress ou Ghost | Délai de mise en ligne le plus court |
Pour un regard plus approfondi sur toutes ces alternatives, consultez notre comparaison complète des headless CMS.
Débuter : Vos 15 premières minutes avec Contentful
Voici un walkthrough pratique — pas de théorie, mais les étapes exactes pour passer de zéro à interroger du contenu via GraphQL en environ 15 minutes.
Étape 1 : Créez un compte. Rendez-vous sur contentful.com et créez un compte gratuit. Pas de carte de crédit nécessaire.
Étape 2 : Créez un Space. Un Space est votre conteneur de projet. Le niveau gratuit vous donne un Starter Space. Donnez-lui un nom descriptif.
Étape 3 : Définissez un type de contenu. Allez dans Content Model, cliquez sur "Add content type" et créez un type "Article". Ajoutez des champs : Titre (Texte court, requis), Slug (Texte court, validation unique), Corps (Texte riche), Image de couverture (Média) et Date de publication (Date et heure).
Étape 4 : Créez une entrée. Naviguez vers Content, cliquez sur "Add Article" et remplissez les champs. Cliquez sur Publish.
Étape 5 : Récupérez vos clés API. Allez dans Settings -> API Keys. Créez une nouvelle clé API. Vous obtiendrez un Space ID, un token Content Delivery API et un token Content Preview API. Sauvegardez-les.
Étape 6 : Interrogez via le Playground GraphQL. Ouvrez cette URL dans votre navigateur (remplacez avec vos identifiants) :
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}/explore?access_token={CDA_TOKEN}Étape 7 : Récupérez depuis votre application. Utilisez l'exemple JavaScript fetch de la section APIs ci-dessus — substituez votre Space ID et votre token CDA, et vous récupérez du contenu en direct.
Conseil pro : L'URL du Playground GraphQL n'est pas évidente dans l'interface Contentful. Vous pouvez la trouver sous Settings -> API Keys -> GraphQL Playground URL, ou la construire manuellement en utilisant le template ci-dessus. Mettez-la en favori — vous l'utiliserez constamment pendant le développement.
FAQ
Qu'est-ce que Contentful CMS et comment ça fonctionne ?
Contentful est un headless CMS API-first qui stocke du contenu structuré dans un hub cloud et le délivre via des APIs REST et GraphQL. Contrairement à WordPress, il n'a pas de frontend — vous construisez le vôtre avec n'importe quel framework. Les éditeurs de contenu gèrent les entrées via l'application web de Contentful, et les développeurs récupèrent ce contenu via les APIs.
Contentful est-il gratuit ?
Oui, Contentful offre un niveau Community gratuit qui inclut 10 utilisateurs, 100K appels API par mois, 50 Go de bande passante CDN et un Starter Space. C'est suffisant pour le prototypage et les petits projets. Les plans payants commencent à $300/mois pour le niveau Lite, avec des niveaux Premium et Enterprise sur devis.
Qu'est-ce que la modélisation de contenu dans Contentful ?
La modélisation de contenu consiste à définir des types de contenu structurés avec des champs, des validations et des références — comme concevoir un schéma de base de données mais pour le contenu. Vous créez des types comme "Article de blog" ou "Produit" avec des champs spécifiques (titre, corps, image, catégorie), et chaque entrée suit cette structure. C'est la fondation de Contentful.
Comment Contentful se compare-t-il à WordPress ?
Contentful est headless (API uniquement, pas de frontend intégré), tandis que WordPress associe la gestion du contenu au rendu basé sur des thèmes. Contentful excelle dans la diffusion multicanal — le même contenu peut servir le web, le mobile et l'IoT. WordPress excelle par sa simplicité — vous obtenez un site fonctionnel en quelques minutes sans développeur.
Contentful est-il adapté à un usage enterprise ?
Oui, Contentful est l'une des plateformes headless CMS les plus adoptées en entreprise. Les plans Enterprise incluent SSO, contrôle d'accès granulaire basé sur les rôles, journaux d'audit, support dédié, SLA à 99,99% et appels API illimités. Des entreprises comme Spotify, Vodafone, Chanel et Atlassian l'utilisent pour des opérations de contenu à grande échelle.
Quels sont les inconvénients de Contentful ?
Les principales limitations incluent : pas d'édition visuelle intégrée dans le produit de base (Studio est un module complémentaire payant), imprévisibilité des tarifs à l'échelle en raison des dépassements d'API et des coûts supplémentaires, pas de workflow de gestion des traductions, dépendance au développeur pour tous les changements frontend, JSON de texte riche nécessitant des rendus personnalisés, et dépendance fournisseur sans option d'auto-hébergement.
Contentful supporte-t-il GraphQL ?
Oui, nativement. Chaque espace Contentful dispose d'un schéma GraphQL auto-généré basé sur vos types de contenu. Vous pouvez interroger avec filtrage, pagination, tri et requêtes spécifiques à une locale. L'endpoint est à graphql.contentful.com/content/v1/spaces/{SPACE_ID}, authentifié avec votre token Content Delivery API.
Combien coûte Contentful par mois ?
Le niveau gratuit coûte $0. Lite est à $300/mois avec 20 utilisateurs et 1M d'appels API. Premium commence autour de $2.000+/mois avec des tarifs sur mesure. Enterprise se situe entre cinq et six chiffres annuellement. Attention aux coûts cachés : dépassements d'appels API, frais du module Contentful Studio, tarification Ninetailed et services professionnels.
Contentful peut-il gérer plusieurs langues ?
Oui, Contentful a une gestion native des locales avec des remplacements au niveau du champ — chaque champ peut stocker différentes valeurs par locale. Cependant, il n'y a pas de workflow de traduction intégré, ni de mémoire, ni de glossaire. Vous avez besoin d'intégrations tierces comme Phrase, Smartcat ou Lokalise pour gérer le vrai processus de traduction à l'échelle.
Qu'est-ce que Contentful Studio ?
Contentful Studio est un module complémentaire de constructeur de pages visuelles passé en disponibilité générale au printemps 2024. Il permet aux non-développeurs de composer des pages en utilisant des composants en glisser-déposer avec un aperçu en direct. Il nécessite une intégration frontend (vos composants doivent être enregistrés avec le SDK de Studio) et c'est un module complémentaire payant — non inclus dans les plans Contentful de base.