Grzegorz Kalmus
Autor
Hreflang to jeden z najważniejszych atrybutów HTML dla stron wielojęzycznych i międzynarodowych. Jeśli prowadzisz serwis dostępny w kilku językach lub kierujesz go do użytkowników w różnych krajach, prawidłowe wdrożenie hreflang decyduje o tym, czy Google pokaże właściwą wersję językową właściwemu użytkownikowi. Błędy w implementacji mogą prowadzić do utraty ruchu organicznego, kanibalizacji słów kluczowych i zduplikowanej treści w oczach wyszukiwarek.
Co to jest hreflang i do czego służy?
Atrybut hreflang (formalnie: rel="alternate" hreflang="x") to sygnał dla Google i Yandex informujący, że dana strona istnieje w kilku wariantach językowych lub regionalnych. Dzięki niemu wyszukiwarka wie, którą wersję strony wyświetlić użytkownikowi na podstawie jego języka przeglądarki i lokalizacji geograficznej.
Hreflang nie jest oficjalnym czynnikiem rankingowym, ale ma ogromny wpływ na doświadczenie użytkownika i techniczne SEO. Google sam przyznaje, że bez poprawnych hreflangów może wyświetlać niewłaściwą wersję językową, co bezpośrednio obniża współczynnik konwersji i wydłuża czas znalezienia przez roboty odpowiedniej strony.
Warto przy tym pamiętać, że Bing i inne wyszukiwarki hreflang ignorują – używają własnych mechanizmów geotargetowania. Jeśli zależy Ci na pozycjonowaniu stron internetowych w wielu krajach, chętnie pomożemy zaplanować strategię technicznego SEO.
Kiedy potrzebujesz hreflang?
Nie każda strona wymaga implementacji hreflang. Powinieneś go użyć gdy:
- Twoja strona istnieje w kilku wersjach językowych (np. polska i angielska wersja sklepu)
- Kierujesz ten sam język do różnych regionów (np. angielski dla UK i USA –
en-gbien-us) - Masz zduplikowane treści na różnych domenach lub subdomenach dla różnych krajów
- Treść jest podobna, ale zawiera różne ceny, waluty, kontakty lub oferty dla różnych rynków
Hreflang nie jest potrzebny gdy masz jedną wersję językową strony, nawet jeśli planujesz ją rozbudować w przyszłości. Nie stosuj go też dla stron z nieznaczącymi różnicami – drobne zmiany w kontakcie to za mało, żeby uzasadnić pełną implementację.
Składnia i metody implementacji
Hreflang możesz zaimplementować na trzy sposoby. Każdy jest równoważny z punktu widzenia Google, ale różni się technicznie:
1. Znacznik w sekcji <head> HTML
Najpopularniejsza metoda. W sekcji <head> każdej strony dodajesz linki do wszystkich wersji językowych:
<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" href="https://example.com/de/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />2. Nagłówek HTTP
Stosowana głównie dla plików PDF i innych dokumentów nie-HTML. Serwer zwraca hreflang w nagłówku odpowiedzi HTTP:
Link: <https://example.com/pl/dokument.pdf>; rel="alternate"; hreflang="pl",
<https://example.com/en/dokument.pdf>; rel="alternate"; hreflang="en"3. Mapa strony XML (sitemap)
Najlepsza opcja dla dużych serwisów z setkami stron. Nie wymaga modyfikacji każdej strony HTML osobno:
<url>
<loc>https://example.com/pl/</loc>
<xhtml:link rel="alternate" hreflang="pl" href="https://example.com/pl/" />
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/" />
</url>Kody języków i regionów – ISO 639-1 i ISO 3166-1
W hreflang używasz dwóch typów kodów:
- Kod języka (ISO 639-1): dwuliterowy kod języka, np.
pl(polski),en(angielski),de(niemiecki),fr(francuski) - Kod regionu (ISO 3166-1 alpha-2): dwuliterowy kod kraju, np.
PL(Polska),GB(Wielka Brytania),US(Stany Zjednoczone)
Łączy się je myślnikiem: en-GB, en-US, pt-BR (portugalski brazylijski), zh-CN (chiński uproszczony).
Możesz użyć samego kodu języka (hreflang="pl") bez podawania regionu – Google wtedy sam dobierze użytkowników mówiących po polsku, niezależnie od kraju. Kod regionu stosuj tylko gdy treść jest naprawdę różna dla różnych krajów tego samego języka (inne ceny, prawo, kontakty).
Uwaga na pułapki: nie istnieje hreflang="cn" – poprawny kod Chin to zh-CN lub zh-TW. Użycie uk oznacza język ukraiński, nie Wielką Brytanię (ta to en-GB).
Tag x-default – domyślna strona dla nieznanych języków
Tag hreflang="x-default" wskazuje wersję strony dla użytkowników, których język nie pasuje do żadnej zdefiniowanej wersji językowej. To typowo strona główna, strona wyboru języka lub anglojęzyczna wersja jako domyślna dla rynku globalnego.
<link rel="alternate" hreflang="x-default" href="https://example.com/" />Nie jest obowiązkowy, ale Google go rekomenduje. Bez x-default, gdy użytkownik z nieobsługiwanego rynku wejdzie na stronę, Google sam zdecyduje co mu pokazać – często nieoptymalne zachowanie.
Wymóg obustronności (bidirectional requirement)
To jeden z najczęstszych błędów wdrożeniowych. Hreflang musi być dwukierunkowy: każda wersja językowa musi wskazywać na wszystkie pozostałe, w tym na siebie samą.
Przykład dla strony PL i EN: strona polska musi mieć linki do PL i EN, a strona angielska musi mieć linki do EN i PL. Jeśli strona angielska nie odwzajemnia linku do polskiej, Google może zignorować cały sygnał hreflang.
Oznacza to też konieczność self-referencing hreflang – każda strona musi wskazywać na samą siebie:
<!-- Na stronie polskiej -->
<link rel="alternate" hreflang="pl" href="https://example.com/pl/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />Hreflang a canonical – jak unikać konfliktów
Hreflang i canonical to dwa niezależne sygnały, ale muszą ze sobą współgrać. Podstawowa zasada: URL w hreflang musi być tym samym URL-em, który jest kanonicznym. Nie możesz w hreflang wskazywać na URL, który sam w sobie ma canonical na inną stronę.
Przykład błędu:
- Strona A (wersja PL) ma canonical na stronę B
- Strona B ma hreflang wskazujący na stronę A
W takiej konfiguracji Google będzie zdezorientowany. Poprawne podejście: hreflang wskazuje tylko na strony kanoniczne, a każda ze stron ma canonical na siebie samą (self-canonical).
Google wprost zaznacza w swojej dokumentacji: hreflang URLs must be canonically self-referencing. Tworzenie stron internetowych z poprawną obsługą kanonicznych URL i hreflang wymaga przemyślanej architektury technicznej – warto zadbać o to od samego początku projektu.
Typowe konfiguracje hreflang
Polska + angielska wersja globalna
<link rel="alternate" hreflang="pl" href="https://example.com/pl/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/en/" />Polska + Niemcy + angielska fallback
<link rel="alternate" hreflang="pl" href="https://example.com/pl/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/en/" />Angielski dla różnych regionów
<link rel="alternate" hreflang="en-US" href="https://example.com/us/" />
<link rel="alternate" hreflang="en-GB" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en-AU" href="https://example.com/au/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />Implementacja w WordPress – WPML, Polylang, Yoast
WordPress oferuje kilka sprawdzonych rozwiązań do obsługi hreflang:
WPML (WP Multilingual Plugin)
Najbardziej rozbudowane narzędzie do wielojęzycznych stron w WordPress. WPML automatycznie generuje hreflang w sekcji head, obsługuje sitemap XML i poprawnie zarządza tłumaczeniami stron, postów oraz taksonomii. Płatny plugin, ale bardzo dojrzały – godny polecenia dla rozbudowanych projektów e-commerce lub korporacyjnych serwisów.
Polylang
Darmowa alternatywa dla WPML. Polylang również automatycznie generuje poprawne tagi hreflang. Wersja Pro oferuje integrację z WooCommerce. Dla mniejszych projektów w zupełności wystarczy darmowa wersja.
Yoast SEO (Premium)
Yoast SEO Premium współpracuje z WPML i Polylang – może automatycznie uzupełniać meta SEO dla różnych wersji językowych. Sam Yoast bez wtyczki do wielojęzyczności nie generuje hreflang – potrzebujesz kombinacji narzędzi.
Implementacja w Next.js
Next.js to popularny framework React, który dobrze obsługuje wielojęzyczność. Przy tworzeniu stron internetowych w Next.js masz dwie główne ścieżki:
next-intl
Biblioteka next-intl w połączeniu z App Router automatycznie generuje hreflang na podstawie skonfigurowanych lokalizacji. W pliku layout.tsx definiujesz lokalizacje, a metadane generowane przez generateMetadata zawierają gotowe tagi alternate.
Next.js Metadata API
Od Next.js 13 możesz używać wbudowanego Metadata API. Pole alternates.languages automatycznie generuje odpowiednie tagi link w sekcji head:
export const metadata = {
alternates: {
canonical: 'https://example.com/pl/',
languages: {
'en': 'https://example.com/en/',
'de': 'https://example.com/de/',
'x-default': 'https://example.com/',
},
},
};Next.js renderuje wtedy poprawne tagi <link rel="alternate"> bez potrzeby ręcznego kodowania.
Narzędzia do walidacji hreflang
Po wdrożeniu hreflang koniecznie zwaliduj implementację. Dostępne narzędzia:
Generator i walidator Aleydy Solis
Narzędzie dostępne na aleydasolis.com pozwala zarówno generować poprawne tagi hreflang, jak i je walidować. Wystarczy podać URL strony, by sprawdzić czy wszystkie tagi są poprawnie skonfigurowane.
Screaming Frog SEO Spider
Profesjonalne narzędzie do crawlowania stron. Screaming Frog posiada dedykowany raport hreflang (zakładka „Hreflang”), który pokazuje:
- Brakujące tagi zwrotne (missing return tags)
- Niezgodności URL-i
- Niekanoniczne URL-e w hreflang
- Błędne kody języków i regionów
Google Search Console
W GSC sprawdź raport „Wyniki wyszukiwania” filtrując po krajach – po kilku tygodniach powinieneś widzieć ruch z każdej wersji językowej. Sekcja „Indeksowanie” > „Strony” pokaże błędy crawlowania, które mogą blokować indeksowanie wersji językowych.
Najczęstsze błędy w implementacji hreflang
Na podstawie audytów SEO widać, że błędy hreflang są bardzo powszechne. Oto lista najgroźniejszych:
- Brak tagów zwrotnych – strona EN nie odwzajemnia tagu do PL. Google ignoruje cały sygnał.
- Błędne kody języków –
hreflang="english"zamiasthreflang="en",hreflang="cn"zamiasthreflang="zh-CN". - Niekanoniczne URL-e w hreflang – wskazywanie na URL z parametrami (
?lang=pl) zamiast na kanoniczny adres. - Brak self-referencing – strona nie wskazuje na samą siebie w hreflang.
- Hreflang na stronach 301 – wskazywanie na URL, który przekierowuje na inny. Zawsze używaj docelowych, finalnych URL-i.
- Niespójność z sitemap – wersje językowe są w head, ale nie w sitemap XML – utrudnia to crawlowanie.
- Blokowanie wersji językowych w robots.txt – subdirectory lub subdomena z inną wersją językową przypadkowo zablokowana dla robotów.
Debugowanie hreflang w Google Search Console
Jeśli po wdrożeniu hreflang Google nadal wyświetla złe wersje językowe, sprawdź kilka rzeczy w GSC:
- URL Inspection Tool – sprawdź czy strona jest zindeksowana i jakie tagi hreflang Google widzi po renderowaniu JavaScript
- Raport Indeksowanie > Strony – szukaj błędów 404 dla wersji językowych
- Raport Sitemap – upewnij się, że wszystkie wersje językowe mają przesłaną sitemap
Pamiętaj, że Google potrzebuje czasu na przetworzenie zmian hreflang – zwykle 2-4 tygodnie po wdrożeniu zanim zobaczysz efekty w GSC i wynikach wyszukiwania.
Prawidłowo wdrożone hreflang to fundament skutecznego pozycjonowania w środowisku wielojęzycznym. Jeśli masz pytania dotyczące technicznego SEO lub potrzebujesz audytu swojej implementacji, skontaktuj się z nami. Sprawdź też naszą ofertę cenową usług SEO – pomagamy firmom w całej Polsce skutecznie pozycjonować wielojęzyczne serwisy.
Podsumowanie – hreflang w praktyce
Hreflang to potężne narzędzie, ale tylko gdy jest poprawnie wdrożone. Kluczowe zasady to: zawsze używaj kodów ISO, zapewniaj obustronność tagów, wskazuj wyłącznie na kanoniczne URL-e i nie zapomnij o x-default. Niezależnie czy budujesz sklep e-commerce, serwis korporacyjny czy bloga – przy ekspansji na rynki zagraniczne hreflang powinien być na liście priorytetów technicznych.
Zachęcamy do zapoznania się z oficjalną dokumentacją Google dotyczącą hreflang – to najbardziej aktualne i wiarygodne źródło wiedzy na temat tego atrybutu.
Potrzebujesz pomocy przy tworzeniu stron internetowych z obsługą wielu języków lub audytu istniejącej implementacji? Sprawdź naszą ofertę pozycjonowania stron – chętnie pomożemy Twojemu projektowi zaistnieć na międzynarodowych rynkach.
