Najważniejsze jest spójne oznaczenie wersji językowych na całej stronie i poprawne zestawienie ich rel="alternate" hreflang, najlepiej w sekcji
lub w XML-sitemapie. Dzięki temu wyszukiwarki wyświetlają właściwą wersję językową użytkownikom, a serwis może skalować się w środowisku programmatic SEO.Plan działania dla hreflang w serwisie programmatic SEO
- Audyt i zakres: zidentyfikuj wszystkie wersje językowe i regiony. Sprawdź spójność URL-ów i metadanych.
- Struktura języków i regionów: zdecyduj, czy używasz pl, en, de czy wersji z regionem pl-PL, en-US, de-DE. Ustal zasady dla stron głównych i podstron.
- Metoda implementacji: wybierz head (HTML) i/lub sitemap. W serwisach o dużej liczbie stron rekomendowana jest dwutorowa implementacja.
- Generator hreflangów: w serwisach programmatic SEO wygeneruj tagi dynamicznie w szablonach, tak by dla każdej strony powstał zestaw wariantów.
- Walidacja i monitoring: uruchom testy hreflang i raport International Targeting w Google Search Console. Monitoruj błędy i poprawiaj conforme.
Zasady doboru kodów hreflang
- Język: używaj ISO 639-1 (np. pl, en, de).
- Kraj/region (opcjonalnie): używaj ISO alpha-2 (np. PL, US, GB).
- Warianty: jeśli nie ma wariantu regionalnego, użyj samego języka (np. en, pl). Dla wersji regionalnych stosuj formę en-US, pl-PL, de-DE.
- Spójność: każdy wariant strony powinien wskazywać na wszystkie inne warianty. Nie zostawiaj pojedynczych linków bez dopasowań.
Metody implementacji hreflang
1) W sekcji <head> każdej strony
- Dodaj zestaw linków hreflang: , , , , .
- Upewnij się, że każdy wariant ma odpowiednią flagę hreflang i że wszystkie warianty danej strony są wymienione.
2) W mapie witryny (sitemap)
- Dodaj wpisy hreflang dla każdej pary URL-wariant. Każdy wariant powinien mieć odnośniki do innych wariantów tej samej treści.
- Zadbaj o aktualizacje, gdy dodajesz nowy język lub region.
3) Kombinacja head + sitemap
- Stabilizuj mapę witryny jako źródło dodatkowe i w razie konfliktów polegaj na danych z head.
Krok po kroku wdrożenia (dla serwisu z dużą liczbą stron)
- Zidentyfikuj wszystkie warianty językowe i regionowe dla każdej strony.
- Ustal jednolity format kodów hreflang (np. en-US, pl-PL, de-DE).
- Wygeneruj dynamicznie tagi hreflang w szablonach HTML dla każdej strony.
- Utwórz lub zaktualizuj mapę witryny o wszystkie warianty językowe.
- Dodaj x-default na stronę domową lub na stronę wyboru języka.
- Przeprowadź walidację: sprawdź, czy każdy wariant wskazuje na wszystkie inne warianty tej samej treści.
- Uruchom testy w Google Search Console i narzędziach do walidacji hreflang.
- Monitoruj raport International Targeting i reaguj na błędy.
Walidacja i monitorowanie
- Walidacja ręczna: porównaj, czy dla każdej strony istnieje odpowiednia lista wariantów.
- Automatyczne testy: użyj narzędzi do weryfikacji hreflang i skanu strony, by wykryć błędy.
- GSC: przeglądaj raport International Targeting pod kątem błędów i ostrzeżeń.
- Audyt okresowy: co kwartał sprawdzaj, czy nowe warianty zachowują spójność.
Pułapki i najczęstsze błędy
- Niedopasowanie URL-i między wariantami (różne domeny, subdomeny lub ścieżki bez koordynacji).
- Używanie błędnych kodów języka/regionu lub ich mieszanie (np. en-US z hreflang="en").
- Brak równych wariantów dla stron dużej części serwisu (niektóre versje bez odpowiedników).
- Brak x-default lub błędne wskazanie strony domowej jako domyślnej.
- Nieaktualne wersje w sitemapie lub head, które prowadzą do nieistniejących stron.
- Konflikt między hreflang a canonicalem prowadzący do dezinformacji wyszukiwarek.
Przykłady praktyczne
Przykład 1: podstawowa konfiguracja dla kilku wariantów
- W sekcji head: <link rel="alternate" href="{URL_PL}" hreflang="pl" />, <link rel="alternate" href="{URL_EN}" hreflang="en" />, <link rel="alternate" href="{URL_EN_US}" hreflang="en-us" />, <link rel="alternate" href="{URL_X_DEFAULT}" hreflang="x-default" />.
- W mapie witryny: do każdej strony dodaj wpisy o wariantach i odnośniki między nimi.
Przykład 2: dynamiczne generowanie dla serwisu programmatic SEO
- Szablon generuje listę hreflang dla wszystkich wariantów danej treści.
- Dla każdej strony tworzony jest zestaw linków do wersji en-US, en-GB, pl-PL itd.
- Spójność kodów i ścieżek jest weryfikowana podczas budowania.
Przykład 3: x-default i homepage
- Dodaj tag x-default wskazujący na stronę wyboru wersji językowej lub homepage.
- Upewnij się, że homepage nie jest pomijana w zestawieniu wariantów.
Często Zadawane Pytania
Czym jest hreflang i do czego służy?
Hreflang informuje wyszukiwarki o wersjach językowych i regionalnych strony, aby wyświetlać właściwą wersję użytkownikom w zależności od ich języka i kraju.
Jakie kody języka i regionu używać w hreflang?
Stosuj ISO 639-1 dla języka i ISO 3166-1 alpha-2 dla kraju, np. pl-PL, en-US. Używaj także ogólnego pl lub en wtedy, gdy nie trzeba wariantu regionalnego.
Czy hreflang musi być w HEAD czy w sitemap?
Można zastosować w obu miejscach. Najpierw w sekcji head każdej strony, a także w mapie witryny dla dużych serwisów.
Co to jest x-default i kiedy go używać?
x-default wskazuje stronę domyślną, która wyświetla użytkownikom bez wyraźnego dopasowania. Nadaje się na stronę główną lub stronę wyboru języka.
Jak wdrożyć hreflang w serwisie z dużą liczbą stron (programmatic SEO)?
Stwórz dynamiczny generator tagów hreflang w szablonach, utrzymuj tabelę wersji językowych, generuj wszystkie warianty dla każdej strony i testuj masowo.
Jak przetestować poprawność hreflang?
Użyj narzędzi do walidacji hreflang, przeglądaj błędy w Google Search Console i porównaj zestawienie wariantów z faktyczną treścią.
Jakie są najczęstsze błędy w hreflang?
Niedopasowanie URL-i, niezgodne kody języka/regionu, brak równych wariantów, albo błędny x-default.
Czy hreflang wpływa na pozycjonowanie?
Hreflang wpływa na widoczność w wynikach międzynarodowych i doświadczenie użytkownika; pośrednio może wpływać na pozycje, jeśli tagi są błędne lub niepełne.