W skrócie
- Googlebot wykonuje JavaScript, ale renderowanie jest odroczone i kosztowne, więc treść w surowym HTML indeksuje się szybciej i pewniej.
- Linki muszą być elementami <a> z atrybutem href; nawigacja po kliknięciu w JavaScript jest dla robota niewidoczna.
- Renderowanie po stronie serwera (SSR) lub statyczne (SSG) rozwiązuje większość problemów z indeksacją SPA.
- Treść ładowana po przewinięciu lub kliknięciu zakładki nie zostanie zaindeksowana, jeśli nie ma jej w DOM po wczytaniu.
Jak to działa i dlaczego ma znaczenie
Gdy robot Google pobiera stronę, najpierw czyta surowy HTML. Jeśli znajdzie w nim treść, linki i meta tagi, może zaindeksować ją od razu. Jeśli HTML zawiera tylko pusty kontener i skrypty, strona trafia do kolejki renderowania, gdzie Google uruchamia ją w przeglądarce opartej na aktualnym Chromium i dopiero wtedy widzi treść. Ta kolejka może trwać od sekund do dni, a przy błędach skryptów, zablokowanych zasobach lub treści zależnej od interakcji renderowanie kończy się pustą stroną. Moja praca to sprawdzenie, co dokładnie widzi robot na każdym szablonie, i doprowadzenie do tego, by widział wszystko.
Przez ostatnie lata frameworki dojrzały do SEO: Next.js, Nuxt, SvelteKit, Astro i Remix domyślnie oferują renderowanie po stronie serwera lub statyczne generowanie stron, a React Server Components ograniczają ilość JavaScriptu wysyłanego do przeglądarki. Problemem przestał być brak narzędzi, a stało się ich niewłaściwe użycie: strony generowane po stronie klienta „bo tak było szybciej”, dane pobierane dopiero po hydracji, meta tagi ustawiane skryptem po wczytaniu. Do tego doszły roboty wyszukiwarek AI, które w większości w ogóle nie wykonują JavaScriptu, więc aplikacja bez SSR jest dla nich niewidoczna.
Typowy przypadek: sklep na React z API, w którym lista produktów w kategorii pobiera się po załadowaniu strony, a stronowanie działa przez przycisk „pokaż więcej”. Google widzi pustą kategorię i żadnego linku do produktów. Drugi: serwis na Next.js z poprawnym SSR, ale z komponentem, który po hydracji podmienia tytuł i opis na wartości domyślne. W obu przypadkach użytkownik niczego nie zauważa, a wyniki wyszukiwania są puste.
Kiedy potrzebujesz tej usługi
- W wynikach Google strona wyświetla się z tytułem aplikacji zamiast tytułu podstrony, albo z pustym opisem.
- Test adresu w Search Console pokazuje wyrenderowany HTML bez treści, która jest widoczna w przeglądarce.
- Podstrony produktów lub artykułów nie trafiają do indeksu, choć działają po wpisaniu adresu.
- Po przejściu z klasycznego CMS na aplikację JavaScript ruch organiczny spadł, mimo zachowania treści.
- Narzędzie do podglądu bez JavaScriptu pokazuje pustą stronę z jednym kontenerem.
Co dokładnie robię
Porównanie surowego HTML z wyrenderowanym DOM
Dla każdego szablonu sprawdzam, co jest w odpowiedzi serwera, a co pojawia się dopiero po wykonaniu skryptów: treść, linki, nagłówki, meta tagi, dane strukturalne.
Test renderowania przez Google
Używam testu adresu w Search Console i testu wyników z elementami rozszerzonymi, żeby zobaczyć stronę oczami robota i wykryć błędy skryptów oraz zablokowane zasoby.
Strategia renderowania
Rekomenduję SSR, SSG, ISR lub hybrydę per typ strony: statyczne dla treści, serwerowe dla kategorii i produktów, klienckie tylko dla paneli użytkownika.
Linki i nawigacja
Weryfikuję, czy wszystkie linki są elementami <a href>, czy stronowanie i filtry mają własne adresy, czy menu nie opiera się na zdarzeniach kliknięcia.
Meta tagi, canonical i dane strukturalne
Pilnuję, by tytuł, opis, canonical, hreflang i JSON-LD były w HTML z serwera i nie były nadpisywane po hydracji.
Routing i kody odpowiedzi
Sprawdzam, czy nieistniejące adresy zwracają 404, czy przekierowania działają na serwerze, a nie w JavaScript, i czy adresy nie zawierają fragmentów z krzyżykiem.
Wydajność i hydracja
Mierzę ilość JavaScriptu, czas hydracji i INP; wskazuję, które komponenty mogą być serwerowe lub wczytywane leniwie.
Wytyczne i weryfikacja z zespołem
Dokument dla programistów z przykładami kodu i listą kontrolną; po wdrożeniu powtarzam testy na środowisku testowym i produkcji.
Jak przebiega współpraca
- 1tydzień 1
Diagnoza szablonów
Testuję każdy typ strony w trzech wersjach: surowy HTML, wyrenderowany DOM, widok robota Google; spisuję różnice.
- 2tydzień 2
Rekomendacje i warsztat z programistami
Przekazuję strategię renderowania, listę poprawek i omawiam ją z zespołem, żeby wybrać rozwiązania zgodne z architekturą.
- 3tydzień 3–6
Wdrożenie i testy
Zespół wdraża zmiany na środowisku testowym; ja sprawdzam renderowanie, linki i meta tagi przed publikacją.
- 4tydzień 7–10
Publikacja i monitoring indeksacji
Po starcie śledzę raport indeksowania i statystyki robota, zgłaszam mapy XML i kluczowe adresy do ponownego sprawdzenia.
Czego się spodziewać i kiedy
| Horyzont | Co się dzieje | Czym to mierzę |
|---|---|---|
| 2 tygodnie | Wiesz dokładnie, czego robot nie widzi i jak to naprawić w Waszym frameworku. | Lista różnic HTML–DOM per szablon, dokument wytycznych. |
| 1–2 miesiące | Po wdrożeniu SSR lub poprawek treść i linki są w surowym HTML; Google indeksuje podstrony bez kolejki renderowania. | Test adresu w Search Console, liczba zaindeksowanych adresów, czas od publikacji do indeksacji. |
| 2–4 miesiące | Podstrony pojawiają się w wynikach z poprawnymi tytułami i opisami; rośnie ruch na kategoriach i produktach. | Wyświetlenia i kliknięcia w Search Console, ruch organiczny w GA4. |
Koszt i model rozliczenia
- Framework i obecna strategia renderowania
- Liczba szablonów i typów stron
- Czy wymagana jest zmiana architektury (np. przejście na SSR), czy tylko poprawki
- Zakres wsparcia dla zespołu programistów po diagnozie
Wycena diagnozy zawiera testy wszystkich szablonów, dokument wytycznych z przykładami i warsztat z programistami. Opisz projekt, a dostaniesz wycenę z zakresem prac rozpisanym na etapy.
Najczęstsze błędy, które widzę
- Nawigacja oparta na onClick z przekazaniem adresu w JavaScript zamiast elementów <a href>.
- Treść pobierana z API dopiero po hydracji, przez co surowy HTML zawiera pusty kontener.
- Blokowanie w robots.txt katalogu ze skryptami lub API, bez których robot nie wyrenderuje strony.
- Renderowanie wstępne tylko dla Googlebota (dynamic rendering) jako rozwiązanie docelowe – Google traktuje to jako obejście, nie zalecany standard.
Kiedy tego nie polecam
- Strona działa na klasycznym CMS z odrobiną JavaScriptu do interakcji – problem indeksacji leży gdzie indziej; zacznij od audytu technicznego.
- Aplikacja jest panelem po zalogowaniu bez treści publicznych – nie ma czego indeksować; SEO dotyczy tylko strony marketingowej.
- Zespół planuje przepisać aplikację za kilka miesięcy – lepiej wpisać wymagania renderowania do nowego projektu niż naprawiać obecny.
Pytania i odpowiedzi
Czy Google indeksuje strony w JavaScript?
Tak, Googlebot renderuje JavaScript w aktualnej wersji Chromium. Robi to jednak z opóźnieniem i ograniczonym budżetem, więc treść dostępna dopiero po wykonaniu skryptów indeksuje się wolniej i mniej niezawodnie niż treść w HTML z serwera.
Co to jest SSR i czy jest potrzebne do SEO?
Server-Side Rendering to generowanie pełnego HTML na serwerze przy każdym żądaniu, tak że robot i użytkownik od razu dostają treść. Dla stron, które mają rankować, jest to najpewniejsze rozwiązanie; dla treści rzadko zmienianych wystarczy generowanie statyczne (SSG).
Czy Next.js jest dobry dla SEO?
Tak, pod warunkiem użycia renderowania serwerowego lub statycznego dla stron publicznych i pilnowania meta tagów oraz linków. Sam framework nie gwarantuje widoczności – widziałem serwisy na Next.js, które wszystko renderowały po stronie klienta.
Dlaczego Google widzi inny tytuł niż w przeglądarce?
Najczęściej tytuł jest ustawiany skryptem po wczytaniu, a robot zapisuje wersję z surowego HTML albo z momentu renderowania przed podmianą. Tytuł, opis i canonical powinny być w HTML z serwera.
Czy wyszukiwarki AI i ChatGPT widzą strony w JavaScript?
Większość robotów modeli językowych nie wykonuje JavaScriptu i czyta tylko surowy HTML. Aplikacja bez SSR jest dla nich pusta, co ma znaczenie, jeśli zależy Ci na cytowaniach w odpowiedziach AI.