Migracja z WordPressa do Astro: jak przenieść stronę, headless lub w całości, bez utraty pozycji w Google

Krótka odpowiedź

WordPress napędza 40,1% wszystkich stron internetowych według danych W3Techs z 13 października 2026 r., więc większość migracji stron zaczyna się właśnie od niego. Przewodnik migracji przygotowany przez samo Astro opisuje dwie drogi: zachować WordPressa jako headless CMS i pozwolić Astro zbudować front-end albo całkowicie przenieść treści poza WordPressa.

W obu przypadkach praca, która chroni Twój ruch, wygląda tak samo: zachowaj każdy adres URL, który przynosi odwiedziny, przenieś tytuły i opisy generowane przez wtyczkę SEO, skopiuj folder uploads, zastąp wtyczki, które działały na froncie strony, i daj każdemu zmienionemu adresowi URL stałe przekierowanie. Jeśli zrobisz to w tej kolejności, nowa strona może ładować się szybciej i kosztować mniej w utrzymaniu, a przy tym nie zacznie budować pozycji w Google od zera.

WordPress headless czy pełna przeprowadzka?

Astro opisuje w dokumentacji obie drogi: WordPress jako headless CMS i migrację z WordPressa, gdzie do przeniesienia treści proponuje narzędzie wordpress-export-to-markdown.

Co zobaczyliśmy na ośmiu działających stronach na WordPressie

13 października 2026 r. sprawdziliśmy osiem witryn zbudowanych na WordPressie, od bloga z aktualnościami WordPress.org po dużych wydawców, żeby zobaczyć, na czym może opierać się migracja:

• Siedem z ośmiu udostępniało wpisy publicznie przez REST API, pod adresem /wp-json/wp/v2/posts. Ósma odpowiedziała kodem 401: niektórzy dostawcy hostingu i wtyczki bezpieczeństwa blokują API, więc sprawdź swoje, zanim oprzesz na nim plan.
• Trzy z ośmiu zwracały przy każdym wpisie także dane Yoast SEO. Yoast dodaje do standardowych odpowiedzi REST API pole yoastheadjson z tytułem, opisem, kanonicznym adresem URL, tagami Open Graph i znacznikami schema, które wtyczka renderuje dla danej strony (dokumentacja Yoast dla deweloperów). To metadane SEO, których potrzebujesz, gotowe do ponownego użycia.
• Wszystkie adresy URL wpisów, które zwróciły, kończyły się ukośnikiem, a w pięciu z siedmiu witryn zawierały też rok, jak w /2026/10/nazwa-wpisu/. Astro musi dokładnie odtworzyć tę strukturę, inaczej każdy wpis będzie potrzebował przekierowania.
• Sześć z ośmiu nadal ładowało jQuery, co dobrze pokazuje, ile kodu front-endowego wnosi motyw WordPressa i z jak dużej jego części przebudowa w Astro może zrezygnować.

Migracja z WordPressa do Astro krok po kroku

1. Spisz każdy adres URL. Od wersji 5.5 WordPress publikuje mapę witryny pod adresem /wp-sitemap.xml, chyba że wtyczka SEO zastępuje ją własną (Make WordPress Core). Dodaj raport Strony z Google Search Console dla najdłuższego dostępnego zakresu dat, zanotuj strukturę odnośników z ekranu Ustawienia → Bezpośrednie odnośniki i wyeksportuj reguły z wtyczki do przekierowań, jeśli jej używasz.
2. Wybierz headless albo pełną przeprowadzkę, korzystając z tabeli powyżej. Pozostałe kroki dotyczą obu wariantów; przy headless „eksport” oznacza odczytywanie tych samych danych z API podczas budowania strony.
3. Wyeksportuj treści. Ekran Narzędzia → Eksport tworzy plik WXR, czyli eksport XML z wpisami, stronami, własnymi typami treści, komentarzami, własnymi polami, kategoriami, tagami, własnymi taksonomiami i użytkownikami (dokumentacja WordPressa). Jeśli wolisz eksport skryptem, REST API zwraca do 100 wpisów na stronę wyników, razem z wyrenderowanym HTML każdego z nich.
4. Skopiuj przesłane pliki. Obrazów nie ma w pliku XML: znajdują się w wp-content/uploads, razem z kopiami w innych rozmiarach, które WordPress utworzył z każdego z nich. Zachowaj oryginały, pozwól, by potrzebne rozmiary wygenerował moduł astro:assets, i zdecyduj, czy stare adresy URL obrazów pozostaną takie same, czy będą wymagały przekierowań.
5. Przenieś metadane SEO. Jeśli strona korzysta z Yoast SEO, odczytaj yoastheadjson z REST API dla każdego wpisu i każdej strony: dostaniesz ostateczny tytuł i opis, a nie szablony, które przechowuje wtyczka. W przeciwnym razie pobierz je z własnych pól wtyczki zapisanych w pliku eksportu.
6. Odbuduj szablony jako komponenty Astro. Przy pełnej przeprowadzce zamień wpisy i strony w content collections albo przenieś je do nowego CMS; przy headless WordPressie pobieraj je z API. Przejrzyj HTML kilku wpisów pod kątem shortcode'ów, osadzeń i kodu z page builderów, który często trzeba wyczyścić, żeby treść dobrze wyglądała poza starym motywem.
7. Zastąp wtyczki, które działały na froncie strony. Formularze potrzebują własnego endpointu (Cloudflare Worker, usługa obsługi formularzy albo Twój CRM), wyszukiwarkę może zastąpić statyczny indeks, na przykład Pagefind, a w sprawie komentarzy trzeba podjąć decyzję: zachować je, przenieść do zewnętrznej usługi albo je zamknąć. Wtyczki do cache'owania nie mają już nic do roboty, gdy strony są budowane z wyprzedzeniem.
8. Dopasuj strukturę adresów URL. Bezpośrednie odnośniki WordPressa zwykle kończą się ukośnikiem, co zgadza się z domyślnym formatem katalogów, w jakim Astro generuje strony. Odnośniki oparte na dacie stają się dynamicznymi trasami (routing w Astro), takimi jak /[year]/[month]/[slug]/; archiwa kategorii i tagów potrzebują własnych stron albo przekierowania.
9. Przekierowuj na serwerze, łącznie z pozostałościami po WordPressie. Statyczny build Astro bez adaptera zamienia skonfigurowane przekierowania w strony meta refresh (opis konfiguracji Astro), więc ustaw przekierowania 301 jeden do jednego tam, gdzie strona jest hostowana. Poza zmienionymi wpisami uwzględnij adresy URL, które WordPress tworzy sam: /feed/, skrócone odnośniki ?p=, strony załączników, archiwa autorów i każdy przeniesiony plik z /wp-content/uploads/.
10. Uruchom stronę i obserwuj. Przełącz DNS, zostaw starą instalację WordPressa dostępną tylko dla siebie, dopóki nowa strona nie zostanie sprawdzona, i śledź raporty indeksowania w Search Console przez kolejne tygodnie. Nasza checklista SEO przy migracji strony obejmuje dzień startu i 90 dni po nim.

Co zmienia się po przeprowadzce

Jak zachować SEO

Wytyczne Google dotyczące przenoszenia witryny ze zmianą adresów URL mają tu pełne zastosowanie: przypisz każdy stary adres URL do najbliższego nowego odpowiednika, użyj stałych przekierowań po stronie serwera i utrzymuj je co najmniej przez rok. WordPress ułatwia zachowanie identycznych adresów URL bardziej niż większość platform, bo jego bezpośrednie odnośniki z końcowym ukośnikiem pasują do domyślnych ustawień Astro; najwięcej pracy wymaga odtworzenie ścieżek z datami, archiwów i każdego adresu URL wygenerowanego przez wtyczkę.

Następnie sprawdź, co stary motyw i wtyczki dodawały do każdej strony: tagi canonical, obrazy Open Graph, dane strukturalne, tagi hreflang z wtyczki wielojęzycznej i reguły dla robotów. Wszystko, czego zabraknie na nowej stronie, to sygnał, który Google straci w dniu przełączenia.

Jak Dardo przeprowadza migrację z WordPressa

Przeprowadzki z WordPressa realizujemy w ramach usługi migracji strony internetowej: inwentaryzacja adresów URL i treści, decyzja między headless a pełną przeprowadzką, najpierw jedna reprezentatywna strona odbudowana i sprawdzona w uzgodnionych szerokościach ekranu, a potem pozostałe szablony, formularze i przekierowania. Sama budowa to tworzenie stron internetowych w Astro. Jeśli dopiero zastanawiasz się, czy w ogóle odchodzić z WordPressa, nasze porównanie WordPressa i strony dedykowanej pokazuje, kiedy opłaca się każda z opcji, a przewodniki po migracji z Framera i z Webflow omawiają inne częste punkty wyjścia.

Jeśli rozważasz przeprowadzkę, wyślij nam adres strony i napisz, co chcesz zmienić. Zanim przygotujemy wycenę, powiemy, czy lepiej sprawdzi się headless, czy pełna przeprowadzka.