Spis treści
Co to jest hreflang?
Hreflang to atrybut, który mówi Google, że ta sama strona istnieje w innych wersjach językowych lub regionalnych, i wskazuje ich adresy. Dzięki temu Google może pokazać użytkownikowi wersję w jego języku lub dla jego kraju.
Hreflang nie wykrywa języka ani nie przekierowuje użytkowników. Google pisze wprost, że do wykrywania języka strony nie używa ani hreflang, ani atrybutu lang, tylko własnych algorytmów. Hreflang jedynie łączy wersje w grupę, tak by w wynikach pojawiła się ta właściwa.
Składnia i kody języków
Najczęściej stosowany zapis to znaczniki link w kodzie strony:
<!-- w sekcji head KAŻDEJ wersji językowej -->
<link rel="alternate" hreflang="pl" href="https://example.com/pl/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="de-AT" href="https://example.com/at/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
Wartość hreflang to kod języka w formacie ISO 639-1, np. pl, en, de, a opcjonalnie po myślniku kod regionu w formacie ISO 3166-1 alfa-2, np. de-AT dla niemieckiego w Austrii. Sam kod regionu bez języka jest błędem. Uwaga na pułapkę: dla Wielkiej Brytanii poprawny kod to en-GB, a nie en-UK.
Najważniejsza zasada według Google: każda wersja językowa musi wskazywać siebie oraz wszystkie inne wersje. Jeśli strona A wskazuje B, a B nie wskazuje A, odwołanie może zostać pominięte.
Co oznacza x-default?
x-default to zarezerwowana wartość, której Google używa, gdy żaden z podanych języków ani regionów nie pasuje do użytkownika. Najczęściej wskazuje stronę z wyborem języka albo wersję uniwersalną, np. angielską. Nie jest obowiązkowa, ale porządkuje sytuację dla użytkowników spoza obsługiwanych rynków.
Trzy sposoby wdrożenia
Kod HTML
link w sekcji head
Nagłówki HTTP
Link w odpowiedzi serwera
Mapa witryny
xhtml:link w sitemap
Dla czego
Kod HTML
zwykłe strony HTML
Nagłówki HTTP
pliki inne niż HTML, np. PDF
Mapa witryny
duże serwisy z wieloma wersjami
Zaleta
Kod HTML
najprostsze do sprawdzenia
Nagłówki HTTP
działa bez zmian w treści pliku
Mapa witryny
nie obciąża kodu stron
Wada
Kod HTML
dużo kodu przy wielu językach
Nagłówki HTTP
wymaga konfiguracji serwera
Mapa witryny
trudniej zauważyć błąd
Google pisze, że te trzy metody są dla niego równoważne. Wystarczy wybrać jedną i stosować ją konsekwentnie. Przy dużych serwisach i sklepach wygodna bywa mapa strony XML.
Najczęstsze błędy
- Brak odwołań zwrotnych: wersje nie wskazują się nawzajem.
- Błędne kody: en-UK zamiast en-GB, sam kod kraju bez języka.
- Sprzeczny canonical: wszystkie wersje wskazują jedną jako kanoniczną.
- Adresy, które nie działają: przekierowania, błędy 404 albo strony z noindex w hreflang.
- Automatyczne przekierowanie po IP lub języku przeglądarki, przez które robot nie może zobaczyć innych wersji.
Komentarz Sebastiana – konsultanta SEO i AI
Sebastian Baryś · freelancer SEO i Google Ads
Hreflang to jedno z tych wdrożeń, które łatwo zrobić „prawie dobrze”. Najczęściej widzę brak odwołań zwrotnych: polska wersja wskazuje angielską, a angielska polskiej już nie. Dla Google taki sygnał jest niepełny i może zostać zignorowany.
Drugi częsty problem pojawia się w sklepach: canonical każdej wersji językowej wskazuje stronę polską, a hreflang próbuje wskazać wersje zagraniczne. Dwa sygnały się wykluczają. Zanim zacznę poprawiać hreflang, zawsze najpierw porządkuję canonicale.
Powiązane pojęcia
Jak Hreflang łączy się z innymi pojęciami ze słownika:
- hreflang łączy wersje językowe i regionalne strony
- hreflang wymaga wzajemnych odwołań
- hreflang współpracuje z canonical Canonical
FAQ – najczęstsze pytania
Co to jest hreflang?
Hreflang to atrybut, który informuje Google o istnieniu różnych wersji językowych lub regionalnych tej samej strony. Dzięki niemu Google może pokazać użytkownikowi wersję w jego języku lub dla jego kraju, np. polskiemu użytkownikowi stronę po polsku, a niemieckiemu po niemiecku.
Jak wygląda kod hreflang?
Najczęściej to znaczniki link w sekcji head, np. link rel="alternate" hreflang="pl" href="adres polskiej wersji". Każda wersja językowa musi zawierać takie znaczniki dla siebie i dla wszystkich pozostałych wersji. Kod języka podaje się w formacie ISO 639-1, a opcjonalny kod regionu w formacie ISO 3166-1 alfa-2, np. de-AT.
Co oznacza hreflang x-default?
x-default to zarezerwowana wartość, która wskazuje stronę domyślną. Google pokazuje ją wtedy, gdy żaden z podanych języków ani regionów nie pasuje do użytkownika. Często jest to strona z wyborem języka albo wersja angielska.
Czy hreflang jest potrzebny na stronie w jednym języku?
Nie. Hreflang ma sens tylko wtedy, gdy ta sama treść istnieje w kilku wersjach językowych lub regionalnych. Strona wyłącznie po polsku go nie potrzebuje. Google nie używa też hreflang ani atrybutu lang do wykrywania języka strony.
Jak sprawdzić, czy hreflang działa?
Sprawdź, czy każda wersja wskazuje siebie i wszystkie pozostałe, czy adresy zwracają kod 200, nie przekierowują i nie mają noindex, oraz czy canonical każdej wersji wskazuje ją samą. Pomagają crawlery SEO, które raportują brakujące odwołania zwrotne i błędne kody.
Masz stronę lub sklep w kilku językach?
Sprawdzę wdrożenie hreflang, odwołania zwrotne, canonicale i mapę witryny, a potem przygotuję listę poprawek, żeby każdy kraj widział właściwą wersję strony.
Sebastian Baryś
Odpowiadam osobiście, bez pośredników