![Guida a Contentful CMS: Funzionalità, Prezzi, API GraphQL & Esempi di Codice [2026]](/_next/image?url=https%3A%2F%2Fmedia.techsy.io%2Ftechsy-io%2Fhero-106-1200x630.webp&w=3840&q=75)
Contentful è un CMS headless API-first che centralizza i tuoi contenuti in un hub cloud e li distribuisce tramite REST e GraphQL a qualsiasi frontend — web, mobile, IoT, digital signage, qualunque cosa tu stia costruendo. Questa guida copre tutto ciò che le altre guide saltano: esempi di codice reali, prezzi precisi e limiti onesti.
Usiamo Sanity (un diretto concorrente di Contentful) in produzione su quattro siti e dieci lingue, quindi affrontiamo questo argomento dalla prospettiva di chi lavora sul campo, non da quella di un venditore.
Panoramica Rapida
| Dettaglio | Info |
|---|---|
| Tipo | CMS headless (API-first) |
| Fondato | 2013, Berlino |
| Ideale Per | Team enterprise, contenuti multi-canale, progetti con localizzazione intensiva |
| Non Ideale Per | Sviluppatori singoli con budget limitati, blog semplici, team che vogliono editing visivo incluso |
| Piano Gratuito | Sì — 10 utenti, 100K chiamate API/mese, 1 space |
| Piani a Pagamento | Da $300/mese (Lite) fino a Enterprise personalizzato |
| API | REST (CDA, CMA, CPA) + GraphQL |
| Modellazione Contenuti | Strutturata: content type, campi, riferimenti, validazioni |
| Funzionalità IA | AI Actions, Contentful Studio, personalizzazione Ninetailed |
| Localizzazione | Supporto locale nativo, nessuna gestione traduzione integrata |
| Open Source | No |
| Principali Concorrenti | Sanity, Strapi, Storyblok, Payload, Hygraph |
Cos'è Contentful?
Contentful è un CMS headless cloud-native API-first — o come lo chiama ora l'azienda, una "piattaforma di contenuti composable." A differenza dei sistemi tradizionali come WordPress, che combinano la gestione dei contenuti con un frontend, Contentful archivia i contenuti strutturati in modo centralizzato e li distribuisce tramite API a qualsiasi canale tu abbia bisogno.
Il concetto chiave è l'architettura disaccoppiata. I tuoi contenuti vivono nel cloud di Contentful. Il tuo frontend — che si tratti di un sito Next.js, di un'app React Native o di un display intelligente — recupera i contenuti tramite le API di Contentful al momento del build o a runtime. Il contenuto non sa né si preoccupa di dove finirà.
Fondato a Berlino nel 2013, Contentful è diventato uno dei maggiori vendor di CMS headless. Brand come Spotify, Vodafone, Chanel e Atlassian gestiscono le loro operazioni di contenuto su di esso. Non è open source e non esiste un'opzione self-hosted — è solo SaaS, il che conta se hai vincoli di compliance sulla residenza dei dati.
Secondo la documentazione ufficiale di Contentful, la piattaforma si posiziona come infrastruttura per i contenuti — un hub che si colloca tra il team editoriale e le esperienze digitali.
Come Funziona Contentful?
Contentful segue un'architettura a tre livelli: definisci il Content Model (lo schema), crei il Contenuto (le voci) e lo distribuisci tramite API. Il contenuto è indipendente dal canale — lo stesso articolo può alimentare il tuo sito web, la tua app mobile e la tua newsletter via email senza alcuna duplicazione.
Tutto passa attraverso le API. Non c'è rendering lato server integrato, nessun template, nessun layer tematico. Costruisci il frontend come preferisci, e Contentful si occupa dell'archiviazione e della distribuzione dei contenuti.
Le Tre API
Contentful offre tre API distinte, ciascuna con il proprio scopo e autenticazione:
- Content Delivery API (CDA): Accesso in sola lettura ai contenuti pubblicati. Supportata dalla CDN di Fastly, le richieste in cache sono veloci e illimitate. Le richieste non in cache sono limitate a 55 al secondo.
- Content Management API (CMA): Accesso in lettura-scrittura per creare e aggiornare contenuti in modo programmatico. Limitata a 10 richieste al secondo. Usata per migrazioni, import massivi o pipeline CI/CD.
- Content Preview API (CPA): Uguale alla CDA ma serve contenuti in bozza. Perfetta per costruire modalità di anteprima nel frontend — gli editor possono vedere le modifiche non pubblicate prima di premere pubblica.
Tutte e tre supportano sia REST che GraphQL. L'autenticazione avviene tramite token Bearer, con token separati per delivery e management.
Ambienti e Space
Pensa agli Space come a progetti e agli Ambienti come a branch git per i tuoi contenuti. Potresti avere un ambiente master per la produzione e uno staging dove gli editor possono lavorare senza influenzare i contenuti live.
Gli ambienti supportano gli alias — puoi puntare l'alias master a un nuovo ambiente per promozioni di contenuto a zero downtime. Se stai scegliendo un framework frontend da affiancare a Contentful, questo modello di ambienti funziona bene con le preview deployment su piattaforme come Vercel o Netlify.
I webhook ti permettono di avviare build, sincronizzarti con sistemi esterni o avviare workflow ogni volta che i contenuti cambiano. La maggior parte dei team li collega alla propria pipeline CI/CD per ricostruire il sito statico ad ogni evento di pubblicazione.
Modellazione dei Contenuti in Contentful
La modellazione dei contenuti consiste nel definire la struttura dei tuoi contenuti — lo "schema" che determina quali campi esistono, che tipo di dati contengono e come i content type si relazionano tra loro. Nella nostra esperienza, è qui che Contentful brilla davvero rispetto alle opzioni CMS più semplici.
Stai essenzialmente progettando uno schema di contenuto, simile alle tabelle di un database ma più flessibile. Un content type "Blog Post" potrebbe avere un titolo (testo breve), un corpo (rich text), un autore (riferimento a un content type Author) e tag (array di stringhe). Ogni voce che crei segue questa struttura.
Tipi di Campo e Validazioni
Contentful offre una buona gamma di tipi di campo:
- Testo breve (Symbol): Titoli, slug, etichette — fino a 256 caratteri
- Testo lungo (Text): Markdown o testo semplice, nessun limite di caratteri
- Rich text: Basato su JSON (non HTML), ti dà pieno controllo sul rendering
- Numero: Intero o decimale
- Data/Ora: Formato ISO 8601
- Booleano: Toggle vero/falso
- Media (Asset): Immagini, video, documenti — archiviati nella pipeline asset di Contentful
- Riferimento (Link): Collega voci ad altre voci o asset
- Oggetto JSON: Dati strutturati in forma libera
- Posizione: Coppie latitudine/longitudine
Ogni campo supporta validazioni: obbligatorio, univoco, pattern regex, limiti di dimensione e messaggi di validazione personalizzati. Puoi anche impostare opzioni di aspetto che controllano come il campo viene renderizzato nell'interfaccia editor.
Riferimenti e Voci Collegate
I riferimenti sono il modo in cui colleghi i content type. Un riferimento "Author" su un Blog Post punta a una voce Author. Un campo "Related Posts" può riferirsi a più voci Blog Post. Questo crea un grafo di contenuti — voci collegate a voci, interrogabili in una singola chiamata API.
Ecco come appare la definizione di un content type Blog Post quando la crei tramite 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" } }
]
}Questo è il tipo di cosa che vorresti tenere nel controllo versione e applicare tramite script di migrazione. Nessun concorrente lo mostra nelle proprie guide a Contentful — parlano della modellazione dei contenuti in astratto senza mostrare come appare effettivamente nel codice.
Interrogare i Contenuti: REST e API GraphQL
Contentful fornisce sia API REST che GraphQL per recuperare i contenuti. REST è immediato per query semplici. GraphQL è meglio quando hai bisogno di dati annidati, più content type in una sola richiesta, o vuoi evitare l'over-fetching. Entrambi usano gli stessi token di autenticazione.
L'endpoint GraphQL è generato automaticamente dal tuo content model. Ogni content type che crei diventa un tipo interrogabile nello schema, con filtri, ordinamento e paginazione integrati. L'endpoint si trova a:
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}Secondo la documentazione GraphQL di Contentful, lo schema si aggiorna automaticamente ogni volta che modifichi i tuoi content type — nessuna gestione manuale dello schema necessaria.
Esempi di Query GraphQL
Ecco una query di base per recuperare i tuoi dieci articoli di blog più recenti con i loro autori:
query {
blogPostCollection(limit: 10, order: publishDate_DESC) {
items {
title
slug
publishDate
author {
name
}
}
}
}Hai bisogno di filtrare per tag e recuperare contenuti in tedesco? Aggiungi una clausola where e un parametro locale:
query {
blogPostCollection(
where: { tags_contains_some: ["javascript"] }
locale: "de"
) {
items {
title
body {
json
}
}
}
}Attenzione: le query GraphQL hanno limiti di complessità. Query profondamente annidate con più riferimenti collegati possono raggiungere il tetto. Contentful calcola la complessità in base al numero di nodi e alla profondità della query. Se stai recuperando blog post con autori, categorie, post correlati e l'autore di ogni post correlato — la somma cresce in fretta.
Fondamenti dell'API REST
L'API REST è più semplice ma richiede più richieste per i dati annidati. Una fetch di base per i blog post punta a https://cdn.contentful.com/spaces/{SPACE_ID}/entries?content_type=blogPost. Ottieni JSON con un array items piatto e un oggetto includes separato per le voci collegate che dovrai risolvere lato client.
Se lavori con TypeScript, l'SDK contentful.js di Contentful gestisce automaticamente la risoluzione dei link e la generazione dei tipi. Per chiamate fetch raw, ecco il JavaScript minimale per interrogare 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();Tutto qui. Nessun SDK richiesto, nessun build step, nessuna dipendenza. Funziona in Node.js, Deno, Cloudflare Workers, nel browser — ovunque tu possa fare richieste HTTP.
Funzionalità Chiave da Conoscere
Contentful ha un set di funzionalità ampio, ma non tutte le funzionalità contano allo stesso modo. Ecco quelle che incidono realmente sulla tua esperienza quotidiana e sulle decisioni architetturali.
Localizzazione (Punti di Forza e Lacune)
Il modello di localizzazione di Contentful è solido a livello infrastrutturale. Definisci i locale per il tuo space (fino a 100+ sui piani Enterprise) e ogni campo può memorizzare valori per locale. Gli override di locale a livello di campo significano che il tuo titolo in tedesco può differire da quello in inglese condividendo però la stessa immagine di copertina.
La lacuna è la gestione delle traduzioni. Contentful ti dà i campi per memorizzare le traduzioni, ma nessun workflow per produrle. Non c'è translation memory, nessun glossario, nessun sistema di assegnazione, nessun tracciamento dei progressi. Hai bisogno di un'integrazione di terze parti — Phrase, Smartcat o Lokalise — per gestire il processo di traduzione vero e proprio. Per i team che gestiscono 10+ lingue (noi ne gestiamo 10 sui nostri siti), questa lacuna diventa costosa rapidamente.
Ambienti e Branching
Gli ambienti funzionano come branch git per il tuo content model e le voci. Crea un ambiente staging, apporta modifiche allo schema, testa con i contenuti, poi promuovi su master quando sei pronto. Gli alias ti permettono di cambiare l'ambiente a cui master punta senza modificare gli URL delle API.
È davvero utile per le migrazioni di schema. Puoi testare un nuovo content type in un ambiente isolato, verificare che il frontend lo gestisca correttamente, poi promuovere — tutto senza toccare i contenuti in produzione. La maggior parte dei team che abbiamo visto usa due o tre ambienti: produzione, staging e occasionalmente un feature branch per migrazioni importanti.
Altre funzionalità degne di nota:
- Ruoli e permessi: Controllo degli accessi granulare — limita gli editor a specifici content type, blocca l'accesso alla pubblicazione per i ruoli junior, ruoli personalizzati sui piani Enterprise, SSO
- Webhook: Avvia build, notifiche Slack o workflow esterni su qualsiasi evento di contenuto
- Rich Text: Basato su JSON, dà pieno controllo sul rendering ma richiede renderer personalizzati per ogni framework frontend
- App Framework: Marketplace con estensioni per editor di campo personalizzati, widget nella sidebar e integrazioni
- Image API: Ridimensionamento al volo, ritaglio, conversione di formato (WebP, AVIF) e ritaglio con punto focale — nessun CDN per immagini separato necessario
Le Novità di Contentful per il 2026
Contentful ha rilasciato aggiornamenti significativi nel corso del 2025 e nel 2026, e nessuna guida concorrente ne copre nemmeno uno. Se stai valutando Contentful basandoti su informazioni del 2023 o 2024, stai lavorando con un quadro incompleto.
AI Actions e Automazione dei Contenuti
Contentful ha lanciato gli AI Actions — workflow di contenuto automatizzati alimentati da grandi modelli linguistici direttamente nell'editor. Gestiscono bozze di traduzione, generazione di metadati SEO, scrittura di testo alternativo, aggiustamenti di tono e riassunti di contenuto. Li accedi dalla sidebar dell'editor e operano sulla voce che stai modificando.
Secondo la copertura di Diginomica, gli AI Actions fanno parte del più ampio spinta di Contentful verso il posizionamento come piattaforma di esperienza digitale (DXP) completa, non solo un CMS headless. La funzionalità è genuinamente utile per automatizzare i compiti editoriali ripetitivi, anche se l'output delle traduzioni ha ancora bisogno di revisione umana — è una prima bozza, non un prodotto finito.
Contentful Studio (Visual Builder)
Contentful Studio è andato GA nella primavera del 2024 ed è maturato significativamente nel corso del 2025. È un costruttore di pagine visivo che permette ai non sviluppatori di comporre pagine con componenti drag-and-drop e anteprima live. Se hai sentito la critica che "Contentful non ha editing visivo" — Studio è la risposta, anche se con alcune avvertenze.
Studio richiede l'integrazione frontend (i tuoi componenti devono essere registrati con l'SDK di Studio) ed è un add-on a pagamento, non incluso nei piani base. Per i team che chiedevano da tempo una costruzione di pagine stile WordPress sopra il content model strutturato di Contentful, è ora un'opzione reale. Storyblok ha ancora il vantaggio per i workflow visual-first, ma il divario si sta riducendo.
Personalizzazione con Ninetailed
Contentful ha acquisito Ninetailed nel 2024 e l'ha rinominata Contentful Personalization. Come ha riportato CMS Critic, questo ti offre A/B testing nativo, segmentazione del pubblico e suggerimenti di varianti guidati dall'IA — tutto accessibile da una scheda Optimization nell'editor.
È notevole perché la personalizzazione richiedeva storicamente un vendor separato (Optimizely, Dynamic Yield, ecc.). Averla integrata nel CMS riduce la complessità dell'integrazione. Il problema: Ninetailed è un prodotto separato con il proprio pricing. Non è "gratis con Contentful."
Prezzi di Contentful: Cosa Costa Davvero
Contentful offre quattro livelli, ma la maggior parte delle guide concorrenti si limita a nominarli senza darti i numeri reali. Ecco cosa stai guardando ad aprile 2026, basato sulla pagina dei prezzi di Contentful:
| Piano | Prezzo | Utenti | Chiamate API/mese | Banda CDN | Space |
|---|---|---|---|---|---|
| Free (Community) | $0 | 10 | 100K | 50 GB | 1 Starter |
| Lite | $300/mese | 20 | 1M | 100 GB | Multipli |
| Premium | Personalizzato (~$2K+/mese) | Illimitati | Illimitate | Personalizzata | Personalizzati |
| Enterprise | Personalizzato (5-6 cifre/anno) | Illimitati | Illimitate | Personalizzata | Personalizzati |
"Costo Mensile Contentful per Piano"
Tabella dei dati
| "Piano" | "Costo Mensile" |
|---|---|
| "Free" | 0 |
| "Lite" | 300 |
| "Premium" | 2000 |
| "Enterprise" | 5000 |
Il piano gratuito è generoso per il prototipaggio e l'apprendimento. Ottieni 10 utenti, 100K chiamate API e banda sufficiente per costruire un progetto reale. Ma i costi crescono rapidamente una volta che lo superi.
Costi nascosti da considerare:
- Addebiti per eccedenza API su Lite: Supera 1M chiamate al mese e vedrai voci di eccedenza nella fattura
- Costi locale: Ogni locale aggiuntivo conta verso i limiti del tuo space — 50 locale a livello di campo si sommano
- Contentful Studio: Il costruttore visivo è un add-on a pagamento, non incluso in Lite né in alcuni piani Premium
- Personalizzazione Ninetailed: Prodotto separato, contratto separato, pricing separato
- Servizi professionali: Assistenza alla migrazione, onboarding e formazione sono fatturati separatamente
- Renderer Rich Text: Non è un costo diretto, ma il tempo di sviluppo per costruire renderer personalizzati per il tuo framework è reale
La nostra valutazione onesta: Il piano gratuito di Contentful è solido per la valutazione e i piccoli progetti. Ma se il budget è una preoccupazione primaria, le alternative CMS open source come Strapi o Payload eliminano completamente i costi di licenza — paghi solo per l'hosting.
Contentful vs Sanity vs Strapi: Come Si Confrontano
Queste sono le tre opzioni di CMS headless che compaiono in quasi ogni valutazione. Abbiamo costruito sistemi in produzione su Sanity, quindi ne conosciamo i punti di forza e le debolezze di prima mano. Ecco un confronto onesto:
| Funzionalità | Contentful | Sanity | Strapi |
|---|---|---|---|
| Tipo | SaaS (closed source) | SaaS + self-host | Open source (self-host o Cloud) |
| Piano Gratuito | 10 utenti, 100K chiamate | 100K chiamate API, 3 utenti | Illimitato (self-host) |
| GraphQL | Nativo | Plugin (GROQ è primario) | Nativo |
| Modellazione Contenuti | GUI + API | Codice (schema-as-code) | GUI + codice |
| Collaborazione in Tempo Reale | Sì | Sì (Presence API) | Limitata |
| Editing Visivo | Add-on Studio | Visual Editing (nativo) | No |
| Localizzazione | Locale nativi | Plugin/personalizzato | Plugin (i18n) |
| Prezzi | Da $300/mese | Da $0 (gratuito generoso) | Gratis (self-host) |
| Ideale Per | Enterprise, multi-canale | Developer-first, schemi flessibili | Budget limitato, self-hosted |
Contentful vince per i team enterprise con grandi operazioni di contenuto e rigorose esigenze di governance. Il sistema di ruoli maturo, SSO, log di audit e SLA al 99,99% sui piani Enterprise sono difficili da eguagliare.
Sanity vince per la developer experience e la flessibilità dello schema. Se preferisci schema-as-code, vuoi la potenza di interrogazione di GROQ e apprezzi le funzionalità di collaborazione in tempo reale, Sanity è la scelta migliore. Leggi la nostra guida completa a Sanity CMS per l'approfondimento.
Strapi vince sul costo. È gratuito da self-hostare senza limiti di chiamate API. Se hai la capacità DevOps per gestire la propria infrastruttura e non hai bisogno di supporto enterprise, Strapi ti dà il massimo CMS per ogni euro speso.
Per un confronto più ampio che include Storyblok, Payload e Hygraph, vedi il nostro confronto completo di CMS headless.
Limitazioni da Conoscere Prima di Scegliere Contentful
Ogni CMS ha compromessi. Ecco quelli di Contentful — con numeri specifici, non vaghe generalizzazioni. Ne abbiamo incontrati diversi quando abbiamo valutato Contentful per la nostra pipeline di contenuti.
I rate limit sono reali. La CDA consente 55 richieste non in cache al secondo. Le risposte in cache CDN sono illimitate, ma se la tua app aggira la cache (rendering lato server su ogni richiesta, per esempio), raggiungerai i limiti in fretta. La CMA è ancora più restrittiva a 10 richieste al secondo — rilevante per script di migrazione e import massivi.
Nessun editing visivo integrato (senza pagare extra). Contentful Studio esiste, ma è un add-on a pagamento che richiede l'integrazione frontend. Se il tuo team si aspetta la costruzione di pagine stile WordPress nel prodotto base, preparati a quella conversazione. Storyblok include l'editing visivo in ogni livello.
Nessuna gestione delle traduzioni. Ottieni i campi locale — e basta. Nessun workflow di traduzione, nessun sistema di assegnazione, nessuna translation memory, nessun tracciamento dei progressi. Per una piattaforma che vende la localizzazione come funzionalità chiave, l'esperienza di traduzione effettiva dipende interamente da strumenti di terze parti come Phrase, Smartcat o Lokalise.
Dipendenza dallo sviluppatore per tutto il frontend. Gli editor di contenuto possono creare e gestire voci. Non possono cambiare i layout di pagina, aggiungere nuove sezioni, modificare la navigazione o aggiornare il frontend in alcun modo senza uno sviluppatore. Questo è intrinseco all'architettura headless, ma è amplificato in Contentful perché il prodotto base non include un costruttore di pagine.
I prezzi diventano imprevedibili su larga scala. I costi di eccedenza API, i limiti basati su locale, i costi aggiuntivi per Studio e Personalization e i servizi professionali creano un modello di pricing difficile da prevedere. Più team con cui abbiamo parlato sono rimasti sorpresi dalla prima fattura dopo il piano gratuito.
Complessità del Rich Text. Il Rich Text di Contentful è basato su JSON, non HTML. Ogni framework frontend ha bisogno di un renderer personalizzato — @contentful/rich-text-react-renderer per React, rich-text-html-renderer per vanilla JS, ecc. Ti dà pieno controllo sul rendering, ma è significativamente più lavoro di sviluppo rispetto ai concorrenti basati su HTML.
Vendor lock-in. Closed source, solo SaaS, nessuna opzione self-hosting. Il tuo contenuto è esportabile tramite API, ma il tuo content model, i workflow e le integrazioni sono specifici di Contentful. Se i prezzi cambiano o le funzionalità vengono deprecate, le tue opzioni sono limitate.
Chi Dovrebbe (e Non Dovrebbe) Usare Contentful
Contentful è una piattaforma solida, ma non è la scelta giusta per ogni progetto. Ecco un framework decisionale per aiutarti a valutare.
Usa Contentful se:
- Sei un team enterprise che gestisce contenuti su più canali (web, mobile, IoT, digital signage)
- Hai bisogno di localizzazione nativa con 50+ locale e override a livello di campo
- Vuoi una piattaforma matura e collaudata con supporto dedicato e SLA al 99,99%
- Il tuo team include sviluppatori a proprio agio con l'architettura API-first
- Hai bisogno di ruoli granulari, permessi, log di audit e SSO
Evita Contentful se:
- Sei uno sviluppatore singolo o un piccolo team con vincoli di budget — guarda Strapi o Payload
- Vuoi un costruttore di pagine visivo incluso nel prodotto base — guarda Storyblok
- Preferisci definizioni di schema code-first e massima flessibilità — guarda Sanity
- Hai bisogno di un CMS semplice per un blog — WordPress o Ghost è più economico e veloce da configurare
- Vuoi fare self-host per ragioni di compliance — guarda Strapi o Payload
| Se hai bisogno di... | Scegli | Perché |
|---|---|---|
| Governance enterprise | Contentful | Ruoli maturi, SSO, log di audit, SLA 99,99% |
| Massima flessibilità per sviluppatori | Sanity | Schema-as-code, GROQ, portable text |
| Zero costi di licenza | Strapi o Payload | Open source, self-hostabile |
| Editing visivo incluso | Storyblok | L'editor visivo è il prodotto principale |
| Blog semplice | WordPress o Ghost | Tempo più breve per il primo post |
Per uno sguardo più approfondito a tutte queste alternative, consulta il nostro confronto completo di CMS headless.
Iniziare: i Tuoi Primi 15 Minuti con Contentful
Ecco una guida pratica — non teoria, ma i passaggi esatti per andare da zero a interrogare contenuti tramite GraphQL in circa 15 minuti.
Step 1: Registrati. Vai su contentful.com e crea un account gratuito. Nessuna carta di credito necessaria.
Step 2: Crea uno Space. Uno Space è il contenitore del tuo progetto. Il piano gratuito ti dà uno Starter Space. Dagli un nome descrittivo.
Step 3: Definisci un Content Type. Vai su Content Model, clicca "Aggiungi content type" e crea un tipo "Article". Aggiungi i campi: Title (Testo breve, obbligatorio), Slug (Testo breve, validazione univoca), Body (Rich text), Cover Image (Media) e Published Date (Data e ora).
Step 4: Crea una Voce. Vai su Content, clicca "Aggiungi Article" e compila i campi. Premi Pubblica.
Step 5: Recupera le chiavi API. Vai su Settings -> API Keys. Crea una nuova chiave API. Otterrai uno Space ID, un token Content Delivery API e un token Content Preview API. Salvali.
Step 6: Interroga tramite GraphQL Playground. Apri questo URL nel browser (sostituisci con le tue credenziali):
https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}/explore?access_token={CDA_TOKEN}Step 7: Recupera dalla tua app. Usa l'esempio JavaScript fetch della sezione API sopra — sostituisci il tuo Space ID e il token CDA e stai già recuperando contenuti live.
Pro tip: L'URL del GraphQL Playground non è ovvio nell'interfaccia di Contentful. Lo trovi sotto Settings -> API Keys -> GraphQL Playground URL, oppure costruiscilo manualmente usando il template sopra. Mettilo tra i preferiti — lo userai costantemente durante lo sviluppo.
FAQ
Cos'è Contentful CMS e come funziona?
Contentful è un CMS headless API-first che archivia contenuti strutturati in un hub cloud e li distribuisce tramite API REST e GraphQL. A differenza di WordPress, non ha un frontend — costruisci il tuo usando qualsiasi framework. Gli editor gestiscono le voci tramite l'app web di Contentful, e gli sviluppatori recuperano quei contenuti tramite API.
Contentful è gratuito?
Sì, Contentful offre un piano Community gratuito che include 10 utenti, 100K chiamate API al mese, 50 GB di banda CDN e uno Starter Space. È sufficiente per il prototipaggio e i piccoli progetti. I piani a pagamento partono da $300/mese per il livello Lite, con i livelli Premium ed Enterprise a prezzi personalizzati.
Cos'è la modellazione dei contenuti in Contentful?
La modellazione dei contenuti significa definire content type strutturati con campi, validazioni e riferimenti — come progettare uno schema di database ma per i contenuti. Crei tipi come "Blog Post" o "Prodotto" con campi specifici (titolo, corpo, immagine, categoria) e ogni voce segue quella struttura. È il fondamento di Contentful.
Come si confronta Contentful con WordPress?
Contentful è headless (solo API, nessun frontend integrato), mentre WordPress abbina la gestione dei contenuti al rendering basato su temi. Contentful eccelle nella distribuzione multi-canale — lo stesso contenuto può servire web, mobile e IoT. WordPress eccelle nella semplicità — ottieni un sito funzionante in pochi minuti senza sviluppatori.
Contentful è adatto all'uso enterprise?
Sì, Contentful è una delle piattaforme CMS headless più adottate dall'enterprise. I piani Enterprise includono SSO, controllo degli accessi granulare basato su ruoli, log di audit, supporto dedicato, SLA al 99,99% e chiamate API illimitate. Aziende come Spotify, Vodafone, Chanel e Atlassian lo usano per operazioni di contenuto su larga scala.
Quali sono gli svantaggi di Contentful?
Le limitazioni principali includono: nessun editing visivo integrato nel prodotto base (Studio è un add-on a pagamento), imprevedibilità dei prezzi su larga scala per eccedenze API e costi aggiuntivi, nessun workflow di gestione delle traduzioni, dipendenza dagli sviluppatori per tutte le modifiche al frontend, Rich Text JSON che richiede renderer personalizzati e vendor lock-in senza opzione self-hosting.
Contentful supporta GraphQL?
Sì, nativamente. Ogni space Contentful ottiene uno schema GraphQL generato automaticamente in base ai tuoi content type. Puoi interrogare con filtri, paginazione, ordinamento e richieste specifiche per locale. L'endpoint si trova a graphql.contentful.com/content/v1/spaces/{SPACE_ID}, autenticato con il tuo token Content Delivery API.
Quanto costa Contentful al mese?
Il piano gratuito costa $0. Lite è $300/mese con 20 utenti e 1M chiamate API. Premium parte da circa $2.000+/mese con pricing personalizzato. Enterprise si aggira attorno alle cinque-sei cifre annue. Fai attenzione ai costi nascosti: addebiti per eccedenza API, commissioni per l'add-on Contentful Studio, pricing di Ninetailed per la personalizzazione e servizi professionali.
Contentful supporta più lingue?
Sì, Contentful ha supporto locale nativo con override a livello di campo — ogni campo può memorizzare valori diversi per locale. Tuttavia, non c'è un workflow di traduzione integrato, nessuna translation memory né glossario. Hai bisogno di integrazioni di terze parti come Phrase, Smartcat o Lokalise per gestire il processo di traduzione effettivo su larga scala.
Cos'è Contentful Studio?
Contentful Studio è un add-on di costruttore di pagine visivo diventato GA nella primavera del 2024. Permette ai non sviluppatori di comporre pagine usando componenti drag-and-drop con anteprima live. Richiede l'integrazione frontend (i tuoi componenti devono essere registrati con l'SDK di Studio) ed è un add-on a pagamento — non incluso nei piani base di Contentful.