English
Słownik · SEO

Hreflang – co to jest i jak go wdrożyć?

Definicja

Hreflang to atrybut, który informuje Google o wersjach językowych lub regionalnych tej samej strony, np. pl, en czy de-AT. Każda wersja musi wskazywać siebie i wszystkie pozostałe, a x-default oznacza stronę domyślną.

Sebastian Baryś
Sebastian Baryś
26 października 2026 5 min czytania

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

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.
Sebastian Baryś

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.

Porozmawiajmy

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ś

Sebastian Baryś

Odpowiadam osobiście, bez pośredników