Darmowa analiza
SEO techniczne

Hreflang: jak oznaczyć wersje językowe strony

Hreflang krok po kroku: składnia, x-default, 3 metody wdrożenia, linki zwrotne, kody języka i regionu oraz typowe błędy. Sprawdź, jak go użyć.

Autor: Tomasz Wieliczko 8 min czytania
Ilustracja do artykułu o oznaczeniu hreflang dla wersji językowych strony

Hreflang to oznaczenie, które mówi Google, że dana podstrona ma odpowiedniki w innych językach lub dla innych krajów, i wskazuje ich adresy. Dzięki niemu wyszukiwarka może pokazać Polakowi wersję polską, a klientowi z Niemiec niemiecką, zamiast mieszać je w wynikach. Wdrażasz je przez znacznik link rel=”alternate” w HTML, nagłówek HTTP lub mapę strony.

W skrócie

  • Hreflang łączy ze sobą wersje tej samej strony w różnych językach lub regionach i pomaga wyszukiwarce wybrać właściwą dla użytkownika.
  • Do wyboru masz trzy metody wdrożenia: znaczniki w sekcji head, nagłówki HTTP (np. dla plików PDF) oraz mapę strony XML; wybierz jedną i trzymaj się jej.
  • Każda wersja musi linkować do wszystkich pozostałych i do samej siebie – brak linków zwrotnych sprawia, że oznaczenie bywa ignorowane.
  • Kod składa się z języka (ISO 639-1) i opcjonalnie regionu (ISO 3166-1 Alpha 2), np. pl, pl-PL, en-GB; sam region bez języka jest niepoprawny.
  • Wartość x-default wskazuje stronę awaryjną, np. wybór języka lub wersję domyślną.
  • Google traktuje hreflang jako wskazówkę, a Bing opiera się głównie na innych sygnałach, jak język treści i znacznik content-language.
Infografika: Hreflang w pigułce

Po co stosować hreflang?

Hreflang stosuje się, gdy ta sama lub bardzo podobna treść istnieje w kilku wersjach językowych albo regionalnych, a Ty chcesz, by wyszukiwarka pokazała użytkownikowi właściwą. Chroni też przed sytuacją, w której wersja angielska wyprzedza w polskich wynikach wersję polską.

Typowe przypadki to:

  • strona w kilku językach (pl, en, de),
  • ten sam język w różnych krajach, np. angielski dla Wielkiej Brytanii i USA, gdzie różnią się waluty, ceny lub słownictwo,
  • sklep sprzedający do kilku państw z różnymi walutami i warunkami dostawy.

Hreflang nie podnosi pozycji strony. Jego zadaniem jest dopasowanie wersji do użytkownika. To element SEO technicznego przydatny wyłącznie wtedy, gdy masz więcej niż jedną wersję językową lub regionalną. Dla strony tylko po polsku – nie jest potrzebny.

Pamiętaj też, że tłumaczenia tej samej strony to nie powielenie treści w złym sensie: Google rozumie, że wersje językowe to odrębne dokumenty, a hreflang pomaga je powiązać.

Jak wygląda składnia hreflang?

Podstawowa składnia to znacznik link z atrybutami rel=”alternate”, hreflang z kodem języka (i ewentualnie regionu) oraz href z pełnym adresem danej wersji. Znaczniki umieszcza się w sekcji head każdej wersji strony.

<link rel="alternate" hreflang="pl" href="https://example.pl/oferta/" />
<link rel="alternate" hreflang="en" href="https://example.pl/en/offer/" />
<link rel="alternate" hreflang="de" href="https://example.pl/de/angebot/" />
<link rel="alternate" hreflang="x-default" href="https://example.pl/" />

Ten sam zestaw znaczników trafia na każdą z wymienionych stron: zarówno polską, jak i angielską oraz niemiecką. Adresy podawaj w pełnej, bezwzględnej postaci (z https i domeną) i w takiej samej wersji, jaka jest ich adresem kanonicznym.

Co to jest x-default?

Wartość x-default oznacza stronę, która ma być pokazana użytkownikom niedopasowanym do żadnej z podanych wersji. Zwykle jest to strona z wyborem języka lub główna wersja serwisu. Nie jest obowiązkowa, ale zalecana.

Jakie są trzy sposoby wdrożenia hreflang?

Hreflang można wdrożyć na trzy równoważne sposoby: w znacznikach HTML w sekcji head, w nagłówkach odpowiedzi HTTP lub w mapie strony XML. Wybierz jedną metodę dla całego serwisu, żeby uniknąć sprzecznych informacji.

1. Znaczniki w HTML

Najpopularniejsza metoda, opisana wyżej. Dobra dla małych i średnich serwisów, ale przy wielu wersjach językowych każda strona zawiera długą listę znaczników, co zwiększa jej rozmiar.

2. Nagłówki HTTP

Przydają się dla plików, które nie mają sekcji head, na przykład PDF-ów. Serwer dodaje nagłówek Link do odpowiedzi:

Link: <https://example.pl/katalog.pdf>; rel="alternate"; hreflang="pl",
      <https://example.pl/en/catalog.pdf>; rel="alternate"; hreflang="en"

3. Mapa strony XML

Przy dużych serwisach wygodniej jest umieścić oznaczenia w mapie strony. Każdy adres zawiera wtedy elementy xhtml:link ze wszystkimi wersjami, również z samym sobą:

<url>
  <loc>https://example.pl/oferta/</loc>
  <xhtml:link rel="alternate" hreflang="pl" href="https://example.pl/oferta/" />
  <xhtml:link rel="alternate" hreflang="en" href="https://example.pl/en/offer/" />
</url>

W nagłówku mapy trzeba zadeklarować przestrzeń nazw xhtml. Jak w ogóle działa mapa i jak ją przygotować, wyjaśniamy we wpisie jak utworzyć i wykorzystać mapę strony.

Dlaczego linki zwrotne są obowiązkowe?

Hreflang działa tylko wtedy, gdy oznaczenie jest wzajemne: jeśli strona A wskazuje stronę B jako wersję alternatywną, strona B musi wskazywać z powrotem na A. Bez takich linków zwrotnych wyszukiwarka może zignorować oznaczenie, bo nie ma pewności, że obie strony faktycznie są powiązane.

Zasada dotyczy całego zestawu: każda wersja językowa zawiera listę wszystkich wersji, w tym samej siebie (tzw. self-reference, czyli odwołanie do samej siebie). Wersja polska musi więc wymieniać pl, en i de, a wersja angielska także pl, en i de. Typowa pułapka pojawia się, gdy dodajesz nowy język, a zapominasz zaktualizować starsze strony.

Jakie kody języka i regionu stosować?

Kod językowy podaje się według normy ISO 639-1 (dwie litery, np. pl, en, de), a opcjonalny kod regionu według ISO 3166-1 Alpha 2 (dwie litery, np. PL, GB, US), oddzielony myślnikiem. Język zawsze występuje pierwszy, a region może się pojawić tylko razem z nim.

Zapis Znaczenie Poprawny?
pl język polski, dowolny kraj Tak
pl-PL język polski dla Polski Tak
en-GB angielski dla Wielkiej Brytanii Tak
en-US angielski dla USA Tak
en-UK błędny kod regionu (poprawnie GB) Nie
PL sam region bez języka Nie
x-default wersja domyślna / wybór języka Tak

Jeśli nie różnicujesz treści dla poszczególnych krajów, wystarczy sam kod języka. Region dodawaj tylko tam, gdzie wersje naprawdę się różnią (waluta, oferta, regulacje). Nie można kierować na kraj bez wskazania języka, na przykład samym „PL”.

Jakie są typowe błędy w hreflang?

Najczęstsze błędy to brak linków zwrotnych, niepoprawne kody języka lub regionu, adresy prowadzące do przekierowań lub błędów oraz sprzeczność z tagiem canonical. Warto je sprawdzać po każdej większej zmianie na stronie.

  • Brak linków zwrotnych – jedna wersja wskazuje drugą, ale nie odwrotnie.
  • Brak odwołania do samej siebie – strona nie wymienia własnego adresu w zestawie.
  • Błędne kody – np. en-UK zamiast en-GB, język podany w złym formacie lub sam kraj.
  • Adresy z przekierowaniem, błędem 404 lub noindex – hreflang powinien wskazywać strony działające, indeksowalne i zwracające kod 200 (zobacz kody odpowiedzi serwera i przekierowanie 301).
  • Konflikt z canonicalem – jeśli wersja językowa ma canonical wskazujący inny język, oznaczenia stają się sprzeczne. Każda wersja powinna mieć canonical na samą siebie, o czym piszemy w artykule o canonical.
  • Mieszanie metod – część oznaczeń w HTML, część w mapie, z różnymi danymi.
  • Niedokończone tłumaczenia – wersja językowa jest nadal po polsku, tylko z innym adresem; to nie jest wersja, którą warto oznaczać.

Do wykrywania takich problemów przydaje się crawler. Jak go użyć, opisujemy w artykule o Screaming Frog; program ma osobną zakładkę z kontrolą hreflang. Sprawdzaj też raporty w Search Console, opisane w poradniku do Google Search Console.

Jak wdrożyć hreflang w sklepie wielojęzycznym i WordPressie?

W WordPressie i sklepach hreflang najlepiej generować automatycznie przez wtyczkę wielojęzyczną lub wtyczkę SEO, zamiast dopisywać go ręcznie. Ręczna edycja przy setkach produktów szybko prowadzi do błędów i niespójności.

  • Wtyczki wielojęzyczne (np. WPML, Polylang, TranslatePress) potrafią dodawać znaczniki hreflang automatycznie dla stron, wpisów i produktów, o ile zaznaczysz powiązania między tłumaczeniami.
  • Struktura adresów – możliwe są katalogi (example.pl/en/), subdomeny (en.example.pl) lub osobne domeny krajowe. Katalogi są najprostsze w utrzymaniu, bo korzystają z mocy jednej domeny.
  • Sklepy – oznaczaj nie tylko strony główne, ale też kategorie i karty produktów, wskazując odpowiednik każdego produktu w danym języku. Jeśli produktu nie ma w innej wersji, nie dodawaj dla niego oznaczenia.
  • Nie przekierowuj automatycznie użytkowników i robotów według adresu IP lub języka przeglądarki bez możliwości wyboru wersji – robot, który zawsze trafia na jedną wersję, nigdy nie zobaczy pozostałych.
  • Sprawdź wynik w kodzie źródłowym strony lub crawlerem, bo wtyczki bywają źle skonfigurowane.

Zapytania dotyczące wielu rynków i integracji hreflang z większymi serwisami zwykle wymagają audytu. Wesprzemy Cię w tym w ramach usługi SEO technicznego.

Czy Bing używa hreflang?

Bing nie opiera się na hreflang tak jak Google. Z dostępnych opracowań wynika, że w identyfikacji języka i odbiorców strony Bing przywiązuje większą wagę do znacznika meta content-language, atrybutu lang w HTML oraz innych sygnałów, takich jak domena czy lokalizacja serwera. Źródła nie są jednak zgodne co do tego, czy hreflang jest dla Bing sygnałem słabym, czy w ogóle go nie odczytuje.

Co to oznacza w praktyce? Poza hreflang dla Google dodaj w sekcji head znacznik content-language i atrybut lang w elemencie html, spójne z oznaczeniami hreflang:

<html lang="pl">
<meta http-equiv="content-language" content="pl" />

Z kolei Google nie korzysta ze znacznika content-language, więc nie zastąpi on hreflang. Dla pełnego pokrycia stosuj oba rozwiązania i sprawdzaj w Bing Webmaster Tools, jak strona jest interpretowana.

Najczęstsze pytania

Czy hreflang jest potrzebny, jeśli mam stronę tylko po polsku?

Nie. Hreflang ma sens wyłącznie wtedy, gdy ta sama treść istnieje w kilku wersjach językowych lub regionalnych. Na stronie wyłącznie polskiej samo oznaczenie niczego nie poprawi.

Czy hreflang wpływa na pozycje w Google?

Nie bezpośrednio. Hreflang nie jest czynnikiem podnoszącym pozycje; pomaga Google wybrać właściwą wersję językową dla użytkownika. Google traktuje go jako wskazówkę, a nie nakaz, więc w niektórych sytuacjach może pokazać inną wersję.

Czy mogę użyć hreflang dla samego kraju, np. „PL”?

Nie. Kod musi zaczynać się od języka. Poprawnie jest „pl” (język polski) lub „pl-PL” (polski dla Polski). Zapis samym regionem jest nieprawidłowy i zostanie zignorowany.

Czy hreflang musi być w każdej z trzech metod naraz?

Nie, wystarczy jedna: znaczniki HTML, nagłówki HTTP albo mapa strony. Najważniejsze, by nie mieszać metod z różnymi danymi i by oznaczenia były spójne oraz zawierały linki zwrotne.

Jak sprawdzić, czy hreflang działa poprawnie?

Zajrzyj do kodu źródłowego strony i sprawdź, czy lista jest kompletna oraz zawiera odwołanie do samej siebie. Następnie przeskanuj serwis crawlerem, który weryfikuje linki zwrotne i kody. Dodatkowo obserwuj raporty indeksowania w Search Console i sprawdzaj, jaka wersja pojawia się w wynikach w danym kraju.

Podsumowanie

Hreflang porządkuje relacje między wersjami językowymi i regionalnymi: wybierz jedną metodę wdrożenia, dbaj o linki zwrotne i poprawne kody, a w WordPressie oprzyj się na sprawdzonej wtyczce. Jeśli prowadzisz sklep lub serwis na kilku rynkach i chcesz mieć pewność, że oznaczenia są poprawne, zajrzyj do oferty SEO techniczne lub zamów audyt SEO.

Tomasz Wieliczko

Poradniki o marketingu internetowym od Xann Marketing z Katowic.

Czytaj także