Przewodnik po Contentful CMS: funkcje, cennik, GraphQL API i przykłady kodu [2026]

Przewodnik po Contentful CMS: funkcje, cennik, GraphQL API i przykłady kodu [2026]

Contentful to headless CMS o architekturze API-first, który przechowuje Twoje treści w centralnym hubie i dostarcza je przez API REST i GraphQL do dowolnego frontendu — WWW, aplikacji mobilnej, IoT, digital signage, czegokolwiek, co właśnie budujesz. Ten przewodnik obejmuje wszystko, co konkurencja pomija: prawdziwe przykłady kodu, rzeczywiste ceny i szczere ograniczenia.

W produkcji używamy Sanity (bezpośredniego konkurenta Contentful) na czterech stronach i w dziesięciu językach, więc piszemy z perspektywy praktyków, a nie materiałów marketingowych dostawcy.

Szybkie podsumowanie

Czym jest Contentful?

Contentful to chmurowy, headless CMS o architekturze API-first — albo, jak dziś określa go sama firma, „komponowalna platforma treści" (composable content platform). W przeciwieństwie do tradycyjnych systemów takich jak WordPress, które łączą zarządzanie treścią z frontendem, Contentful przechowuje ustrukturyzowane treści centralnie i dostarcza je przez API do dowolnego kanału, którego potrzebujesz.

Kluczową koncepcją jest architektura rozdzielona (decoupled). Twoje treści żyją w chmurze Contentful. Twój frontend — czy to strona w Next.js, aplikacja React Native, czy inteligentny wyświetlacz — pobiera treści przez API Contentful w czasie budowania lub w czasie rzeczywistym. Treść nie wie i nie dba o to, gdzie ostatecznie trafi.

Założony w Berlinie w 2013 roku Contentful wyrósł na jednego z największych dostawców headless CMS. Marki takie jak Spotify, Vodafone, Chanel i Atlassian prowadzą na nim swoje operacje treściowe. Nie jest to open source i nie ma opcji self-hosted — to wyłącznie SaaS, co ma znaczenie, jeśli masz wymagania compliance dotyczące rezydencji danych.

Zgodnie z oficjalną dokumentacją Contentful, platforma pozycjonuje się jako infrastruktura dla treści — hub treści znajdujący się pomiędzy Twoim zespołem redakcyjnym a Twoimi doświadczeniami cyfrowymi.

Jak działa Contentful?

Contentful opiera się na trójwarstwowej architekturze: definiujesz model treści (schemat), tworzysz treści (wpisy) i dostarczasz je przez API. Treści są niezależne od kanału — ten sam wpis na blogu może zasilać Twoją stronę WWW, aplikację mobilną i newsletter e-mail bez żadnego duplikowania.

Wszystko przepływa przez API. Nie ma wbudowanego renderowania po stronie serwera, szablonów ani warstwy motywów. Budujesz frontend tak, jak chcesz, a Contentful zajmuje się przechowywaniem i dostarczaniem treści.

Trzy API

Contentful udostępnia trzy odrębne API, każde z własnym przeznaczeniem i uwierzytelnianiem:

• Content Delivery API (CDA): Dostęp tylko do odczytu do opublikowanych treści. Oparty na CDN Fastly, więc żądania z cache są szybkie i nielimitowane. Żądania bez cache są limitowane do 55 na sekundę.
• Content Management API (CMA): Dostęp do odczytu i zapisu, służący do programowego tworzenia i aktualizowania treści. Limit 10 żądań na sekundę. Tego użyjesz do migracji, masowych importów lub pipeline'ów CI/CD.
• Content Preview API (CPA): To samo co CDA, ale serwuje treści w wersji roboczej. Idealne do budowania trybów podglądu na frontendzie — redaktorzy mogą zobaczyć nieopublikowane zmiany przed kliknięciem publikacji.

Wszystkie trzy wspierają zarówno REST, jak i GraphQL. Uwierzytelnianie odbywa się przez tokeny Bearer, z osobnymi tokenami dla delivery i management.

Środowiska i przestrzenie

Traktuj przestrzenie (Spaces) jako projekty, a środowiska (Environments) jako gałęzie git dla Twoich treści. Możesz mieć środowisko master dla produkcji i środowisko staging, w którym redaktorzy pracują bez wpływu na treści produkcyjne.

Środowiska wspierają aliasowanie — możesz skierować alias master na nowe środowisko, aby promować treści bez przestoju. Jeśli wybierasz framework frontendowy do połączenia z Contentful, ten model środowiskowy dobrze współgra z deploymentami podglądowymi na platformach takich jak Vercel lub Netlify.

Webhooki pozwalają wyzwalać buildy, synchronizować z zewnętrznymi systemami lub uruchamiać przepływy pracy przy każdej zmianie treści. Większość zespołów podpina je pod swój pipeline CI/CD, aby przebudowywać stronę statyczną przy każdym zdarzeniu publikacji.

Modelowanie treści w Contentful

Modelowanie treści to miejsce, w którym definiujesz strukturę swoich treści — „schemat" określający, jakie pola istnieją, jakie typy danych przechowują i jak typy treści odnoszą się do siebie. Z naszego doświadczenia wynika, że to właśnie tutaj Contentful naprawdę błyszczy w porównaniu z prostszymi CMS-ami.

W praktyce projektujesz schemat treści, podobny do tabel w bazie danych, ale bardziej elastyczny. Typ treści „Wpis na blogu" może mieć tytuł (krótki tekst), treść (rich text), autora (referencja do typu treści Autor) i tagi (tablica ciągów znaków). Każdy tworzony wpis jest zgodny z tą strukturą.

Typy pól i walidacje

Contentful oferuje solidny zestaw typów pól:

• Krótki tekst (Symbol): Tytuły, slugi, etykiety — do 256 znaków
• Długi tekst (Text): Markdown lub zwykły tekst, bez limitu znaków
• Rich text: Oparty na JSON (nie HTML), daje pełną kontrolę nad renderowaniem
• Liczba (Number): Liczba całkowita lub dziesiętna
• Data/czas: Format ISO 8601
• Wartość logiczna (Boolean): Przełączniki prawda/fałsz
• Media (Asset): Obrazy, wideo, dokumenty — przechowywane w pipeline'ie assetów Contentful
• Referencja (Link): Łączenie wpisów z innymi wpisami lub assetami
• Obiekt JSON: Dowolne dane ustrukturyzowane
• Lokalizacja (Location): Pary szerokość/długość geograficzna

Każde pole wspiera walidacje: wymagane, unikalne, wzorce regex, limity rozmiaru i niestandardowe komunikaty walidacyjne. Możesz też ustawić opcje wyglądu, które kontrolują, jak pole renderuje się w interfejsie edytora.

Referencje i połączone wpisy

Referencje to sposób łączenia typów treści. Referencja „Autor" we wpisie na blogu łączy się z wpisem Autora. Pole „Powiązane wpisy" może odnosić się do wielu wpisów blogowych. Tworzy to graf treści — wpisy połączone z wpisami, które można odpytać w jednym wywołaniu API.

Oto jak faktycznie wygląda definicja typu treści „Wpis na blogu", gdy tworzysz ją przez 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" } }
  ]
}

To jest dokładnie coś, co przechowujesz w kontroli wersji i aplikujesz przez skrypty migracyjne. Żaden konkurent nie pokazuje tego w swoich przewodnikach po Contentful — mówią o modelowaniu treści abstrakcyjnie, nie pokazując, jak to faktycznie wygląda w kodzie.

Odpytywanie treści: API REST i GraphQL

Contentful udostępnia zarówno API REST, jak i GraphQL do pobierania treści. REST jest prosty dla nieskomplikowanych zapytań. GraphQL sprawdza się lepiej, gdy potrzebujesz zagnieżdżonych danych, wielu typów treści w jednym żądaniu lub chcesz uniknąć nadmiernego pobierania (over-fetching). Oba używają tych samych tokenów uwierzytelniających.

Endpoint GraphQL jest generowany automatycznie z Twojego modelu treści. Każdy utworzony typ treści staje się typem, który można odpytać w schemacie, z wbudowanym filtrowaniem, sortowaniem i paginacją. Endpoint znajduje się pod adresem:

https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}

Zgodnie z dokumentacją GraphQL Contentful, schemat aktualizuje się automatycznie przy każdej modyfikacji typów treści — nie trzeba ręcznie zarządzać schematem.

Przykłady zapytań GraphQL

Oto podstawowe zapytanie pobierające dziesięć najnowszych wpisów na blogu wraz z autorami:

query {
  blogPostCollection(limit: 10, order: publishDate_DESC) {
    items {
      title
      slug
      publishDate
      author {
        name
      }
    }
  }
}

Potrzebujesz filtrować po tagu i pobrać treść po niemiecku? Dodaj klauzulę where i parametr locale:

query {
  blogPostCollection(
    where: { tags_contains_some: ["javascript"] }
    locale: "de"
  ) {
    items {
      title
      body {
        json
      }
    }
  }
}

Jedna rzecz, na którą trzeba uważać: zapytania GraphQL mają limity złożoności. Głęboko zagnieżdżone zapytania z wieloma połączonymi referencjami mogą osiągnąć sufit. Contentful oblicza złożoność na podstawie liczby węzłów i głębokości zapytania. Jeśli pobierasz wpisy z autorami, kategoriami, powiązanymi wpisami i autorami każdego powiązanego wpisu, to szybko się sumuje.

Podstawy API REST

API REST jest prostsze, ale wymaga więcej żądań dla zagnieżdżonych danych. Podstawowe pobranie wpisów na blogu trafia w https://cdn.contentful.com/spaces/{SPACE_ID}/entries?content_type=blogPost. Otrzymujesz JSON z płaską tablicą items i osobnym obiektem includes dla połączonych wpisów, który musisz rozwiązać po stronie klienta.

Jeśli pracujesz z TypeScript, SDK contentful.js od Contentful automatycznie zajmuje się rozwiązywaniem linków i generowaniem typów. Dla surowych wywołań fetch, oto minimalny kod JavaScript do odpytania 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();

To wszystko. Nie potrzeba SDK, kroku budowania ani zależności. Działa w Node.js, Deno, Cloudflare Workers, przeglądarce — wszędzie tam, gdzie możesz wykonywać żądania HTTP.

Kluczowe funkcje, które warto znać

Contentful dostarcza szeroki zestaw funkcji, ale nie każda ma jednakowe znaczenie. Oto te, które faktycznie wpływają na codzienne doświadczenie i decyzje architektoniczne.

Lokalizacja (mocne strony i braki)

Model lokalizacji Contentful jest solidny na poziomie infrastruktury. Definiujesz locale dla swojej przestrzeni (do 100+ w planach Enterprise), a każde pole może przechowywać wartości per locale. Nadpisywanie na poziomie pola oznacza, że Twój niemiecki tytuł może różnić się od angielskiego, jednocześnie współdzieląc ten sam obraz hero.

Brakiem jest zarządzanie tłumaczeniami. Contentful daje Ci pola do przechowywania tłumaczeń, ale nie zapewnia przepływu pracy do ich tworzenia. Nie ma pamięci tłumaczeniowej, glosariusza, systemu przypisań ani śledzenia postępów. Potrzebujesz integracji trzeciej strony — Phrase, Smartcat lub Lokalise — aby obsłużyć sam proces tłumaczenia. Dla zespołów zarządzających 10+ językami (my zarządzamy 10 na naszych stronach) ten brak szybko staje się kosztowny.

Środowiska i branchowanie

Środowiska działają jak gałęzie git dla Twojego modelu treści i wpisów. Tworzysz środowisko staging, wprowadzasz zmiany w schemacie, testujesz z treścią, a następnie promujesz do master, gdy jesteś gotowy. Aliasy pozwalają przełączać, na które środowisko wskazuje master, bez zmiany adresów URL API.

To naprawdę przydatne przy migracjach schematu. Możesz przetestować nowy typ treści w izolowanym środowisku, zweryfikować, czy frontend poprawnie go obsługuje, a następnie wypromować — wszystko bez dotykania treści produkcyjnych. Większość zespołów, które widzieliśmy, używa dwóch do trzech środowisk: produkcji, stagingu i okazjonalnie gałęzi funkcyjnej dla dużych migracji.

Inne funkcje warte wspomnienia:

• Role i uprawnienia: Granularna kontrola dostępu — ogranicz edytorów do określonych typów treści, zablokuj dostęp do publikacji dla młodszych ról, niestandardowe role w planach Enterprise, SSO
• Webhooki: Wyzwalaj buildy, powiadomienia Slack lub zewnętrzne przepływy pracy przy dowolnym zdarzeniu treści
• Rich Text: Oparty na JSON, dający pełną kontrolę nad renderowaniem, ale wymagający niestandardowych rendererów dla każdego frameworka frontendowego
• App Framework: Marketplace z rozszerzeniami dla niestandardowych edytorów pól, widżetów paska bocznego i integracji
• Image API: Zmiana rozmiaru, przycinanie, konwersja formatów (WebP, AVIF) i przycinanie do punktu ostrości w locie — nie potrzeba osobnego CDN-a dla obrazów

Co nowego w Contentful na 2026 rok

Contentful dostarczył znaczące aktualizacje w 2025 i na początku 2026 roku, a żaden przewodnik konkurencji nie opisuje żadnej z nich. Jeśli oceniasz Contentful na podstawie informacji z 2023 lub 2024 roku, pracujesz z niepełnym obrazem.

AI Actions i automatyzacja treści

Contentful uruchomił AI Actions — zautomatyzowane przepływy pracy z treścią napędzane dużymi modelami językowymi bezpośrednio w edytorze. Obsługują szkice tłumaczeń, generowanie metadanych SEO, pisanie tekstów alternatywnych, dostosowywanie tonu i podsumowywanie treści. Dostęp do nich masz z paska bocznego edytora i działają na wpisie, który aktualnie edytujesz.

Zgodnie z relacją Diginomica, AI Actions są częścią szerszego dążenia Contentful do pozycjonowania się jako pełna platforma doświadczeń cyfrowych (DXP), a nie tylko headless CMS. Funkcja jest naprawdę przydatna do automatyzacji powtarzalnych zadań redakcyjnych, choć wynik tłumaczenia nadal wymaga ludzkiej weryfikacji — to pierwszy szkic, nie gotowy produkt.

Contentful Studio (kreator wizualny)

Contentful Studio osiągnęło status GA wiosną 2024 roku i znacząco dojrzało w 2025. To wizualny kreator stron, który pozwala osobom nietechnicznym komponować strony z komponentów metodą przeciągnij i upuść, z podglądem na żywo. Jeśli słyszałeś krytykę, że „Contentful nie ma edycji wizualnej", Studio jest odpowiedzią — choć z zastrzeżeniami.

Studio wymaga integracji frontendowej (Twoje komponenty muszą być zarejestrowane w SDK Studio) i jest płatnym dodatkiem, niewłączonym w podstawowe plany. Dla zespołów, które prosiły o budowanie stron w stylu WordPressa na bazie ustrukturyzowanego modelu treści Contentful, to teraz realna opcja. Storyblok nadal ma przewagę w przepływach pracy zorientowanych na wizualność, ale luka się zmniejsza.

Personalizacja z Ninetailed

Contentful przejął Ninetailed w 2024 roku i zmienił nazwę na Contentful Personalization. Jak donosił CMS Critic, daje to natywne testy A/B, segmentację odbiorców i oparte na AI sugestie wariantów — wszystko dostępne z zakładki Optymalizacja w edytorze.

To warte uwagi, ponieważ personalizacja historycznie wymagała osobnego dostawcy (Optimizely, Dynamic Yield itp.). Wbudowanie jej w CMS zmniejsza złożoność integracji. Haczyk: Ninetailed to osobny produkt z własnym cennikiem. Nie jest „darmowe z Contentful".

Cennik Contentful: ile to naprawdę kosztuje

Contentful oferuje cztery poziomy, ale większość przewodników konkurencji tylko je wymienia, nie podając rzeczywistych liczb. Oto, czego możesz się spodziewać na kwiecień 2026, na podstawie strony cennikowej Contentful:

Darmowy plan jest hojny do prototypowania i nauki. Dostajesz 10 użytkowników, 100 tys. wywołań API i wystarczające pasmo, aby zbudować prawdziwy projekt. Ale koszty szybko rosną, gdy go przerośniesz.

Ukryte koszty, które trzeba uwzględnić w budżecie:

• Opłaty za przekroczenie API w Lite: Przekroczysz 1 mln wywołań miesięcznie i zobaczysz pozycje za nadwyżkę na rachunku
• Koszty locale: Każdy dodatkowy locale wlicza się do limitów przestrzeni — 50 locale na poziomie pola szybko się sumuje
• Contentful Studio: Kreator wizualny jest płatnym dodatkiem, niewłączonym w Lite ani nawet w niektóre plany Premium
• Personalizacja Ninetailed: Osobny produkt, osobna umowa, osobny cennik
• Usługi profesjonalne: Pomoc w migracji, wdrożenie i szkolenia są rozliczane osobno
• Renderery Rich Text: Nie jest to bezpośredni koszt, ale czas programistyczny na zbudowanie niestandardowych rendererów dla Twojego frameworka jest realny

Nasza szczera opinia: Darmowy plan Contentful jest solidny do ewaluacji i małych projektów. Ale jeśli budżet jest głównym zmartwieniem, open-source'owe alternatywy CMS takie jak Strapi czy Payload całkowicie eliminują koszty licencji — płacisz tylko za hosting.

Contentful vs Sanity vs Strapi: porównanie

To trzy opcje headless CMS, które pojawiają się w niemal każdej ewaluacji. Zbudowaliśmy systemy produkcyjne na Sanity, więc znamy jego mocne i słabe strony z pierwszej ręki. Oto szczere porównanie:

Contentful wygrywa dla zespołów enterprise z dużymi operacjami treściowymi i ścisłymi wymaganiami governance. Dojrzały system ról, SSO, logi audytowe i SLA 99,99% w planach Enterprise są trudne do pobicia.

Sanity wygrywa w doświadczeniu programisty i elastyczności schematu. Jeśli wolisz schemat jako kod, chcesz mocy zapytań GROQ i cenisz funkcje współpracy w czasie rzeczywistym, Sanity jest lepszym wyborem. Przeczytaj nasz pełny przewodnik po Sanity CMS, aby zgłębić temat.

Strapi wygrywa kosztowo. Jest darmowy w self-hostingu bez limitów wywołań API. Jeśli masz moce DevOps do zarządzania własną infrastrukturą i nie potrzebujesz wsparcia enterprise, Strapi daje najwięcej CMS-a za dolara.

Dla szerszego porównania obejmującego Storyblok, Payload i Hygraph, zobacz nasze pełne porównanie headless CMS.

Ograniczenia, które powinieneś znać przed wyborem Contentful

Każdy CMS ma kompromisy. Oto ograniczenia Contentful, z konkretnymi liczbami, a nie mglistym machaniem rękami. Napotkaliśmy kilka z nich, oceniając Contentful dla naszego własnego pipeline'u treści.

Limity żądań są realne. CDA pozwala na 55 żądań bez cache na sekundę. Odpowiedzi z cache CDN są nielimitowane, ale jeśli Twoja aplikacja omija cache (renderowanie po stronie serwera przy każdym żądaniu, na przykład), szybko osiągniesz limity. CMA jest jeszcze ciaśniejsze — 10 żądań na sekundę, co ma znaczenie dla skryptów migracyjnych i masowych importów.

Brak wbudowanej edycji wizualnej (bez dodatkowej opłaty). Contentful Studio istnieje, ale jest płatnym dodatkiem wymagającym integracji frontendowej. Jeśli Twój zespół oczekuje budowania stron w stylu WordPressa w podstawowym produkcie, przygotuj się na tę rozmowę. Storyblok zawiera edycję wizualną na każdym poziomie.

Brak zarządzania tłumaczeniami. Dostajesz pola locale, i to tyle. Brak przepływów pracy tłumaczeń, systemu przypisań, pamięci tłumaczeniowej, śledzenia postępów. Dla platformy, która sprzedaje lokalizację jako kluczową funkcję, rzeczywiste doświadczenie tłumaczeniowe opiera się całkowicie na narzędziach trzecich stron, takich jak Phrase, Smartcat czy Lokalise.

Zależność od programisty we wszystkim, co frontendowe. Redaktorzy treści mogą tworzyć wpisy i zarządzać nimi. Nie mogą zmieniać układów stron, dodawać nowych sekcji, modyfikować nawigacji ani aktualizować frontendu w żaden sposób bez programisty. To jest nieodłączne dla architektury headless, ale w Contentful jest wzmocnione, ponieważ podstawowy produkt nie zawiera kreatora stron.

Cennik staje się nieprzewidywalny w skali. Przekroczenia wywołań API, limity oparte na locale, koszty dodatków za Studio i personalizację oraz usługi profesjonalne tworzą model cenowy, który trudno prognozować. Wiele zespołów, z którymi rozmawialiśmy, było zaskoczonych pierwszym rachunkiem po darmowym planie.

Złożoność Rich Text. Rich Text w Contentful jest oparty na JSON, nie HTML. Każdy framework frontendowy potrzebuje niestandardowego renderera — @contentful/rich-text-react-renderer dla Reacta, rich-text-html-renderer dla zwykłego JS itd. Daje to pełną kontrolę nad renderowaniem, ale oznacza znacząco więcej pracy programistycznej niż konkurenci oparci na HTML.

Vendor lock-in. Zamknięty kod, tylko SaaS, brak opcji self-hostingu. Twoje treści są eksportowalne przez API, ale Twój model treści, przepływy pracy i integracje są specyficzne dla Contentful. Jeśli ceny się zmienią lub funkcje zostaną wycofane, Twoje opcje są ograniczone.

Kto powinien (a kto nie) używać Contentful

Contentful to silna platforma, ale nie jest właściwym wyborem dla każdego projektu. Oto ramy decyzyjne, które pomogą Ci samodzielnie wybrać.

Użyj Contentful, jeśli:

• Jesteś zespołem enterprise zarządzającym treścią w wielu kanałach (WWW, mobile, IoT, digital signage)
• Potrzebujesz natywnej lokalizacji z 50+ locale i nadpisywaniem na poziomie pola
• Chcesz dojrzałej, sprawdzonej w boju platformy z dedykowanym wsparciem i SLA 99,99%
• Twój zespół obejmuje programistów swobodnie czujących się w architekturze API-first
• Potrzebujesz granularnych ról, uprawnień, logów audytowych i SSO

Pomiń Contentful, jeśli:

• Jesteś samotnym programistą lub małym zespołem z ograniczeniami budżetowymi — spójrz na Strapi lub Payload
• Chcesz wizualnego kreatora stron w podstawowym produkcie — spójrz na Storyblok
• Wolisz definicje schematu w kodzie i maksymalną elastyczność — spójrz na Sanity
• Potrzebujesz prostego CMS-a dla bloga — WordPress lub Ghost są tańsze i szybsze w konfiguracji
• Chcesz self-hostingu ze względów compliance — spójrz na Strapi lub Payload

Aby głębiej przyjrzeć się wszystkim tym alternatywom, sprawdź nasze pełne porównanie headless CMS.

Pierwsze kroki: Twoje pierwsze 15 minut z Contentful

Oto praktyczny przewodnik — nie teoria, ale dokładne kroki, aby od zera dojść do odpytywania treści przez GraphQL w około 15 minut.

Krok 1: Zarejestruj się. Wejdź na contentful.com i utwórz darmowe konto. Karta kredytowa nie jest wymagana.

Krok 2: Utwórz przestrzeń (Space). Przestrzeń to kontener Twojego projektu. Darmowy plan daje Ci jedną przestrzeń Starter. Nazwij ją czymś opisowym.

Krok 3: Zdefiniuj typ treści. Przejdź do Content Model, kliknij „Add content type" i utwórz typ „Article". Dodaj pola: Title (krótki tekst, wymagane), Slug (krótki tekst, walidacja unikalności), Body (rich text), Cover Image (media) i Published Date (data i czas).

Krok 4: Utwórz wpis. Przejdź do Content, kliknij „Add Article" i wypełnij pola. Kliknij Publish.

Krok 5: Pobierz klucze API. Przejdź do Settings -> API Keys. Utwórz nowy klucz API. Otrzymasz Space ID, token Content Delivery API i token Content Preview API. Zapisz je.

Krok 6: Odpytaj przez GraphQL Playground. Otwórz ten adres URL w przeglądarce (podmień na swoje dane uwierzytelniające):

https://graphql.contentful.com/content/v1/spaces/{SPACE_ID}/explore?access_token={CDA_TOKEN}

Krok 7: Pobieraj z aplikacji. Użyj przykładu JavaScript fetch z sekcji API powyżej, podmień swój Space ID i token CDA, i pobierasz treści na żywo.

Wskazówka: Adres URL GraphQL Playground nie jest oczywisty w interfejsie Contentful. Znajdziesz go w Settings -> API Keys -> GraphQL Playground URL lub skonstruujesz ręcznie, używając powyższego szablonu. Dodaj go do zakładek — będziesz go ciągle używać podczas rozwoju.

FAQ

Czym jest Contentful CMS i jak działa?

Contentful to headless CMS o architekturze API-first, który przechowuje ustrukturyzowane treści w chmurowym hubie i dostarcza je przez API REST i GraphQL. W przeciwieństwie do WordPressa nie ma frontendu — budujesz własny, używając dowolnego frameworka. Redaktorzy treści zarządzają wpisami przez aplikację webową Contentful, a programiści pobierają te treści przez API.

Czy Contentful jest darmowy?

Tak, Contentful oferuje darmowy plan Community, który obejmuje 10 użytkowników, 100 tys. wywołań API miesięcznie, 50 GB pasma CDN i jedną przestrzeń Starter. Wystarcza do prototypowania i małych projektów. Płatne plany zaczynają się od 300 $ miesięcznie za poziom Lite, a poziomy Premium i Enterprise są wyceniane indywidualnie.

Czym jest modelowanie treści w Contentful?

Modelowanie treści oznacza definiowanie ustrukturyzowanych typów treści z polami, walidacjami i referencjami — jak projektowanie schematu bazy danych, ale dla treści. Tworzysz typy takie jak „Wpis na blogu" czy „Produkt" z określonymi polami (tytuł, treść, obraz, kategoria), a każdy wpis jest zgodny z tą strukturą. To fundament Contentful.

Jak Contentful wypada w porównaniu z WordPressem?

Contentful jest headless (tylko API, brak wbudowanego frontendu), podczas gdy WordPress łączy zarządzanie treścią z renderowaniem opartym na motywach. Contentful przoduje w dostarczaniu wielokanałowym — ta sama treść może obsługiwać WWW, mobile i IoT. WordPress przoduje w prostocie — działającą stronę masz w kilka minut bez programisty.

Czy Contentful nadaje się do zastosowań enterprise?

Tak, Contentful jest jedną z najczęściej adoptowanych w enterprise platform headless CMS. Plany Enterprise obejmują SSO, granularny dostęp oparty na rolach, logi audytowe, dedykowane wsparcie, SLA 99,99% i nielimitowane wywołania API. Firmy takie jak Spotify, Vodafone, Chanel i Atlassian używają go do operacji treściowych na dużą skalę.

Jakie są wady Contentful?

Kluczowe ograniczenia obejmują: brak wbudowanej edycji wizualnej w podstawowym produkcie (Studio jest płatnym dodatkiem), nieprzewidywalność cen w skali z powodu przekroczeń API i kosztów dodatków, brak przepływu pracy zarządzania tłumaczeniami, zależność od programisty przy wszystkich zmianach frontendowych, Rich Text w JSON wymagający niestandardowych rendererów oraz vendor lock-in bez opcji self-hostingu.

Czy Contentful wspiera GraphQL?

Tak, natywnie. Każda przestrzeń Contentful otrzymuje automatycznie generowany schemat GraphQL oparty na Twoich typach treści. Możesz odpytywać z filtrowaniem, paginacją, sortowaniem i żądaniami dla określonego locale. Endpoint znajduje się pod adresem graphql.contentful.com/content/v1/spaces/{SPACE_ID}, uwierzytelniany tokenem Content Delivery API.

Ile kosztuje Contentful miesięcznie?

Darmowy plan kosztuje 0 $. Lite to 300 $ miesięcznie z 20 użytkownikami i 1 mln wywołań API. Premium zaczyna się od około 2 tys. $+ miesięcznie z indywidualną wyceną. Enterprise kosztuje średnie pięć do sześciu cyfr rocznie. Uważaj na ukryte koszty: opłaty za przekroczenie API, opłaty za dodatek Contentful Studio, ceny personalizacji Ninetailed i usługi profesjonalne.

Czy Contentful obsługuje wiele języków?

Tak, Contentful ma natywne wsparcie dla locale z nadpisywaniem na poziomie pola — każde pole może przechowywać różne wartości dla każdego locale. Nie ma jednak wbudowanego przepływu pracy tłumaczeń, pamięci ani glosariusza. Potrzebujesz integracji trzecich stron, takich jak Phrase, Smartcat czy Lokalise, aby zarządzać samym procesem tłumaczenia na dużą skalę.

Czym jest Contentful Studio?

Contentful Studio to dodatek — wizualny kreator stron, który osiągnął status GA wiosną 2024. Pozwala osobom nietechnicznym komponować strony z komponentów metodą przeciągnij i upuść, z podglądem na żywo. Wymaga integracji frontendowej (Twoje komponenty muszą być zarejestrowane w SDK Studio) i jest płatnym dodatkiem, niewłączonym w podstawowe plany Contentful.