Jak technicznie wdrożyć headless WordPress z WPGraphQL i Next.js App Router? Klient GraphQL, zapytania, ISR, webhooks, next/image i preview bez mieszania z decyzją biznesową.
Ten wpis jest technicznym tutorialem wdrożeniowym: jak połączyć WordPress, WPGraphQL to wtyczka WordPressa udostępniająca treść przez API GraphQL — pobierasz dokładnie te pola, których potrzebujesz, w jednym żądaniu. i Next.js App Router w działającą architekturę. Headless WordPress to WordPress używany wyłącznie jako CMS, z Next.js jako frontendem.
WordPress udostępnia treści przez API (REST lub GraphQL), a Next.js pobiera je, renderuje i serwuje użytkownikowi. Efekt: znany edytor WordPress dla klienta + wydajność i SEO Next.js na froncie.
Kiedy headless WordPress ma sens
Istniejący WordPress z setkami artykułów — klient nie chce migrować treści, ale chce szybszy frontend
Zespół redakcyjny zna WordPress — nie chcą uczyć się Sanity/Strapi
WooCommerce — headless checkout z Next.js, ale zarządzanie produktami w WordPress
Kiedy lepiej wybrać dedykowany headless CMS
Nowy projekt od zera — Sanity/Strapi mają lepszy DX, nie ciągniesz ze sobą PHP
Nie potrzebujesz ekosystemu pluginów WP — mniej zależności = mniej problemów
Jeden deweloper — utrzymanie WordPress + Next.js to dwa systemy do zarządzania
Setup — WPGraphQL
Code
# W WordPress — zainstaluj pluginy:# 1. WPGraphQL (wp-graphql)# 2. WPGraphQL for ACF (opcjonalnie, jeśli używasz ACF)
Po instalacji WPGraphQL: endpoint GraphQL to język zapytań do API, w którym klient precyzyjnie określa, jakie pola chce pobrać — zamiast sztywnych endpointów REST zwracających całe obiekty. dostępny na https://twoj-wordpress.pl/graphql.
Maciej Sala — Product Manager i Frontend Developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty side-projecty.
Cursor czy Antigravity w 2026? Porównanie dwóch filozofii kodowania z AI — pilot kontra autonomiczni agenci. Modele, ceny, limity, stabilność i realna przydatność we frontendzie.
Większość audytów SEO kończy się jako PDF, którego nikt nie wdraża. Pokazuję, dlaczego techniczna optymalizacja działa dopiero, gdy zalecenia zamieniają się w pull requesty, i jak zorganizować ten proces.
Zanim zaczniesz migrację, musisz wiedzieć dokąd. Matryca pięciu zmiennych (rozmiar serwisu, wydajność, e-commerce, model edycji treści, częstotliwość zmian) pokazuje, czy Twój następny stack to Astro, Next.js, czy nadal WordPress — zanim wydasz złotówkę na przepisywanie strony.