Co to jest hreflang? Definicja, składnia i działanie

Hreflang to atrybut HTML, który wskazuje wyszukiwarkom, którą wersję językową lub regionalną strony pokazać danemu użytkownikowi. Google wprowadził adnotację rel=”alternate” hreflang w grudniu 2011 roku, a wartość x-default w kwietniu 2013 roku. Google akceptuje 3 równoważne metody wdrożenia, a każda wersja musi linkować zwrotnie do pozostałych, inaczej adnotacje są ignorowane.

Aktualizacja: 17 października 20263 min czytania
Infografika: budowa adnotacji hreflang, rel alternate, kod języka, kod regionu, x-default i linki zwrotne
Źródło: Google Search Central, Localized versions of your page

Jak działa hreflang?

Hreflang działa tak, że wymienia wszystkie wersje językowe i krajowe strony, łącznie z nią samą, w zestawie linków alternatywnych. Gdy Google znajdzie tę samą treść po polsku, niemiecku i angielsku, adnotacje pomagają podmienić adres URL na właściwy dla osoby szukającej w Warszawie, Berlinie czy Londynie. Hreflang nie podnosi pozycji, tylko decyduje, który z Twoich adresów pojawi się na danym rynku.

Podstawowy zestaw dla jednej podstrony wygląda w sekcji head tak:

  • <link rel=”alternate” hreflang=”pl-PL” href=”https://example.com/pl/” />
  • <link rel=”alternate” hreflang=”de-DE” href=”https://example.com/de/” />
  • <link rel=”alternate” hreflang=”x-default” href=”https://example.com/” />

Składnia hreflang: język, region i x-default

Wartość hreflang to kod języka w formacie ISO 639-1, opcjonalnie z kodem regionu w formacie ISO 3166-1 Alpha 2. Poniżej zasady z dokumentacji Google Search Central.

Kod języka

Kod języka jest obowiązkowy i stoi na początku: pl, de, en. Sam kod kraju, np. PL, jest błędny.

Kod regionu

Opcjonalny region zawęża cel: de-AT dla Austrii, en-GB dla Wielkiej Brytanii. Stosuj GB, a nie UK, bo Google ignoruje kody UK, EU i UN.

x-default

Zarezerwowana wartość x-default wskazuje stronę domyślną dla osób, których język przeglądarki nie pasuje do żadnej wersji. Dobrze sprawdza się na stronie wyboru języka lub globalnej stronie po angielsku.

3 metody wdrożenia hreflang

Google traktuje tagi link w HTML, nagłówki HTTP i mapy witryny XML jako równoważne, więc wybierz jedną metodę dla całej witryny:

MetodaGdzieDla kogo
tagi link w HTMLsekcja headmałe i średnie serwisy
nagłówek HTTP Linkodpowiedź serwerapliki PDF i inne pliki spoza HTML
mapa witryny XMLwpisy xhtml:linkduże sklepy z wieloma wersjami

Hreflang w międzynarodowym SEO

Hreflang to fundament każdej wielorynkowej witryny, którą audytuję, bo bez niego Google często pokazuje złą wersję kraju, np. polskiemu klientowi niemiecką stronę z cenami w euro. Działa razem ze strukturą serwisu (ccTLD, katalog lub subdomena, patrz domena najwyższego poziomu), tagami canonical i przetłumaczoną treścią. Google zaleca osobne adresy URL z hreflang zamiast podmieniania treści po IP, bo Googlebot crawluje głównie z adresów w USA i nie wysyła nagłówka Accept-Language. Dlatego przekierowania oparte na geolokalizacji są ryzykowne dla SEO.

Najczęstsze błędy hreflang

  • Brak linków zwrotnych: strona A wskazuje B, ale B nie wskazuje A.
  • Błędne kody: en-UK zamiast en-GB albo region bez języka.
  • Adresy niekanoniczne: hreflang prowadzi do stron z noindex lub z przekierowaniem 302.
  • Brak samoodwołania: strona nie wymienia samej siebie.

W dużych sklepach każdy błędny adres w zestawie zużywa też crawl budget.

Hreflang a inne wyszukiwarki

Bing nie opiera się na hreflang w ten sam sposób. Na swoim blogu dla webmasterów wymienia jako sygnały języka i kraju meta tag content-language, atrybut lang, nagłówki HTTP, domeny krajowe i lokalizację IP. Na rynkach, gdzie Bing ma znaczący udział, dodaj także meta tag content-language. Dla polskich sklepów wychodzących do Czech warto dodatkowo pamiętać o wyszukiwarce Seznam.

Wskazówka: Generuj hreflang z jednego źródła prawdy (CMS albo arkusz mapowania), nigdy ręcznie. W moich audytach większość błędów hreflang wynika z dodania lub usunięcia jednej wersji językowej bez aktualizacji pozostałych.

Potrzebujesz wdrożenia hreflang na Polskę, Niemcy czy Czechy? Zobacz doradztwo w zakresie międzynarodowego SEO albo przeczytaj o SEO w Czechach.

Najczęstsze pytania: Hreflang

Czy hreflang poprawia pozycje w Google?

Hreflang nie podnosi pozycji bezpośrednio. Wskazuje Google, którą z istniejących wersji językowych pokazać, co ogranicza ruch z niewłaściwych rynków i poprawia klikalność oraz konwersję.

Co oznacza x-default w hreflang?

x-default to zarezerwowana wartość hreflang wskazująca stronę domyślną dla użytkowników, których ustawienia językowe nie pasują do żadnej wersji. Google wprowadził ją w kwietniu 2013 roku.

Czy Google rozpoznaje język strony po hreflang?

Google nie używa hreflang ani atrybutu lang do rozpoznawania języka strony. Język wykrywa własnymi algorytmami, a hreflang wykorzystuje tylko do wyboru między wersjami alternatywnymi.

Hreflang w mapie witryny czy w HTML?

Wybierz dowolną metodę, bo Google traktuje tagi HTML, nagłówki HTTP i mapy witryny XML jako równoważne. W dużych sklepach z wieloma wersjami językowymi mapa witryny jest wygodniejsza w utrzymaniu.

Powiązane pojęcia

SEO międzynarodowe · AI SEO (GEO)

Rośnij na każdym rynku i bądź cytowany przez AI

Hreflang decyduje, który kraj zobaczy którą wersję Twojej strony, a jeden brakujący link zwrotny potrafi kierować Niemców do polskiego sklepu. Audytuję i naprawiam hreflang w serwisach wielorynkowych, by każdy rynek dostał własne strony w Google i w wyszukiwarkach AI.

Pomagam firmom SaaS i sklepom internetowym zdobywać ruch organiczny w Europie i USA oraz sprawiać, że ChatGPT, Gemini, Perplexity i Google AI Overviews polecają ich markę. Każdy projekt zaczynam od bezpłatnego audytu strony, rynków i widoczności w odpowiedziach AI.

Napisz do Adriana

Masz pytanie o to pojęcie albo o SEO swojej strony?

Napisz krótko o stronie, rynkach, na których sprzedajesz, i o tym, co chcesz osiągnąć. Odpowiadam osobiście, nie dział sprzedaży.

  • Bezpłatny wstępny audyt SEO i widoczności w AI
  • Strategia na rynki zagraniczne i wielojęzyczne
  • Odpowiedź w ciągu jednego dnia roboczego
Umów bezpłatną rozmowę
Adrian Dąbrowiecki

Napisz do Adriana

Adrian Dąbrowiecki · Marketer Coffee

Opisz swoją stronę i cele. Zwykle odpowiadam w ciągu jednego dnia roboczego.