Sprawdzanie hreflang: jak zweryfikować tagi hreflang i naprawić błędy
Hreflang mówi wyszukiwarkom, którą wersję językową lub regionalną strony komu pokazać. Idea jest prosta. Wdrożenie jest kruche: każda strona musi wymieniać każdą wersję, każda wersja musi odwzajemniać link, a jeden zły kod lub jeden przekierowujący URL może sprawić, że cały zestaw będzie niewiarygodny. Narzędzie do sprawdzania hreflang czyta to wszystko naraz.
Co robi narzędzie do sprawdzania hreflang
Tagi hreflang jednej strony mówią niewiele. Ważne błędy wychodzą dopiero przy porównaniu stron ze sobą: strona A wymienia stronę B, ale czy strona B wymienia stronę A? Czy B odpowiada 200? Czy B jest swoim własnym canonicalem? Dlatego walidator hreflang dla jednego URL przydaje się do wyrywkowych sprawdzeń, a do sprawdzania hreflang w całej witrynie służy crawler.
Pełne sprawdzenie czyta tagi na każdej stronie, podąża za każdym celem i odpowiada na cztery pytania dla każdego zestawu:
- Czy każdy kod jest poprawny?
- Czy każda strona wymienia siebie i każdą inną wersję?
- Czy każdy cel odwzajemnia link?
- Czy każdy cel to indeksowalny, samokanoniczny URL odpowiadający 200?
Jak działają tagi hreflang
Poradnik Google o zlokalizowanych wersjach stron opisuje trzy sposoby deklarowania hreflang. Wybierz jeden na zestaw.
| Metoda | Strony HTML | PDF-y i pliki | Gdzie się znajduje |
|---|---|---|---|
| Tagi link | ✓ | – | Head w HTML |
| Nagłówek HTTP Link | ✓ | ✓ | Odpowiedź serwera |
| Mapa strony XML | ✓ | ✓ | Plik mapy strony |
1. Tagi link w head HTML
<link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="en-gb" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />
Te same cztery linie trafiają na wszystkie cztery strony, także na stronę x-default.
2. Nagłówek HTTP Link
Przydatny dla PDF-ów i innych plików, które nie mają head HTML:
Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
<https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"
3. Mapa strony XML
<url>
<loc>https://example.com/en-us/pricing/</loc>
<xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
</url>
Mapa strony wymaga zadeklarowania przestrzeni nazw xhtml w elemencie urlset, a każdy wpis url powtarza pełny zestaw. Mapy stron trzymają duże zestawy poza head strony, ale łatwo o nich zapomnieć, gdy strony się zmieniają.
Zasady, których musi przestrzegać każdy zestaw hreflang
- Odwołanie do siebie. Google pisze, że każda wersja musi wymieniać siebie oraz wszystkie inne wersje.
- Linki zwrotne. Jeśli strona A wskazuje stronę B, B musi wskazywać z powrotem A. Google pisze, że jeśli dwie strony nie wskazują się nawzajem, tagi mogą zostać zignorowane.
- Pełne adresy URL. https://example.com/de/, a nie /de/.
- Zdrowe cele. Każdy cel powinien odpowiadać 200, być indeksowalny i być swoim własnym canonicalem. Tag wskazujący przekierowanie, 404 lub stronę z noindex to sygnał, który wyszukiwarki muszą obchodzić.
- Odpowiednik strony. Niemiecka strona cennika powinna wskazywać francuską stronę cennika, a nie francuską stronę główną.
Kody są zgodne ze stałymi standardami. Google wymienia je w poradniku o zlokalizowanych wersjach:
| Kod | Standard | Przykład | Poprawne |
|---|---|---|---|
| Język | ISO 639-1 | de, pt | ✓ |
| Język i region | ISO 3166-1 Alpha 2 | de-at, pt-br | ✓ |
| Język i pismo | ISO 15924 | zh-Hant | ✓ |
| Sam region | brak | us | – |
| Wielka Brytania | GB, nie UK | en-uk | – |
| Wersja zapasowa | Wartość zarezerwowana | x-default | ✓ |
x-default: wersja zapasowa
x-default to wartość zarezerwowana dla strony, którą należy pokazać, gdy żaden inny język ani region z zestawu nie pasuje do odwiedzającego. Google zaleca ją dla stron wyboru języka i stron, które przekierowują odwiedzających na podstawie języka lub lokalizacji.
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
Jest opcjonalna, ale to dobry pomysł na stronie głównej i każdej stronie z wyborem języka. Jak każdy inny cel URL x-default powinien odpowiadać 200, być indeksowalny i być swoim własnym canonicalem, a każda strona w zestawie powinna wskazywać ten sam x-default. Częsty błąd to wskazanie jako x-default adresu, który przekierowuje odwiedzających według lokalizacji, a potem pozwolenie, by to przekierowanie kończyło się błędem.
Najczęstsze błędy hreflang
| Błąd | Jak wygląda | Poprawka |
|---|---|---|
| Brak linku zwrotnego | de pomija en-us | Jedna wspólna lista na zestaw |
| Brak odwołania do siebie | Strona pomija siebie | Dodaj jej własny URL |
| Zły kod regionu | en-uk | en-gb |
| Region bez języka | hreflang="us" | en-us |
| Względny URL | /de/ | Pełny URL https |
| Cel przekierowuje lub zwraca błąd | Francuski URL zwraca 301 | Docelowy URL |
| Cel jest skanonikalizowany | URL z parametrem | Adres kanoniczny |
| Jeden kod, dwa adresy URL | Dwie strony oznaczone de | Jeden URL na kod |
| Tagi poza head | Skrypt wcześniej zamyka head | Przenieś wyżej lub użyj nagłówka |
| Niezgodność języka | hreflang fr, html lang en | Dopasuj do tekstu strony |
Poradnik SEO ProCheck o wdrażaniu hreflang i SEO międzynarodowym omawia każdy z nich dokładniej.
Hreflang i canonicale
Tagi hreflang i canonical działają razem i łatwo się psują nawzajem. Każda wersja językowa powinna być swoim własnym canonicalem. Jeśli niemiecka strona wskazuje angielską jako canonical, mówisz wyszukiwarkom, że niemiecka strona jest duplikatem, co działa przeciwko jej hreflang. Canonical wskazuje w obrębie języka; hreflang wskazuje między językami.
Sprawdź też, czy każdy URL w zestawie hreflang to wersja kanoniczna: ten sam protokół, ten sam host, ten sam końcowy ukośnik. Zestaw, który miesza adresy http i https albo adresy z ukośnikiem i bez, nie przechodzi testu linków zwrotnych, nawet gdy strony są prawidłowe, bo adresy URL nie pasują dokładnie.
Jak sprawdzić hreflang w całej witrynie
- Przecrawluj każdą wersję językową. Jeśli każdy język ma własną domenę lub subdomenę, uwzględnij je wszystkie w crawlu, inaczej nie da się sprawdzić linków zwrotnych.
- Czytaj hreflang z każdej metody, której używasz: head HTML, nagłówka HTTP Link i map stron. Zestaw zadeklarowany na dwa sposoby to zestaw, który może przeczyć sam sobie.
- Najpierw zweryfikuj kody. Jeden zły kod powielony przez szablon może dotknąć tysięcy stron.
- Sprawdź linki zwrotne i odwołania do siebie dla każdej strony.
- Sprawdź kondycję celów: status, indeksowalność i canonical każdego celu.
- Szukaj brakujących zestawów: stron, które mają odpowiedniki w innych językach, ale w ogóle nie mają hreflang.
- Naprawiaj na poziomie szablonu lub wtyczki, nie strona po stronie, a potem przecrawluj ponownie.
Robimy to na własnej witrynie. neova.app działa w 15 językach. W naszym przeglądzie SEO 20 listopada 2026 jej mapy stron XML zawierały 1358 adresów URL, a każdy link hreflang był odwzajemniony: pełna wzajemność. Przy 15 wersjach każda strona wymienia 15 adresów URL, łącznie ze sobą, a każdy z nich musi wymieniać ją z powrotem. Generuj każdy tag w zestawie z jednej wspólnej listy, a linki zwrotne pojawią się same.
Zestawy hreflang to krok 12 checklisty audytu SEO technicznego. Jeśli twoje wersje językowe przekierowują odwiedzających, przeczytaj też poradnik o łańcuchach przekierowań.
Sprawdzaj hreflang w Neova
Kategoria Międzynarodowe w Neova pokazuje wersje językowe i regionalne każdej strony i to, czy wskazują się nawzajem. Czyta hreflang z head HTML i nagłówka HTTP Link, dodaje kolumny Języki hreflang i Cele hreflang do każdej strony HTML i porównuje html lang z hreflang oraz z własnym tekstem strony. Niektóre z testów:
- Brak linku zwrotnego hreflang oraz Brak odwołania hreflang do siebie
- Kod języka w hreflang jest niepoprawny oraz Kod kraju w hreflang jest niepoprawny
- Hreflang wskazuje URL inny niż 200 oraz Hreflang wskazuje skanonikalizowany URL
- Cel zbiorczy hreflang jest zepsuty, ma noindex, jest skanonikalizowany lub niespójny
- Hreflang wskazuje stronę główną wersji językowej, a nie odpowiednik URL
- Hreflang i html lang podają różne języki
- Brak hreflang tam, gdzie istnieją odpowiedniki w innych językach
Każda uwaga mówi, dlaczego jest ważna, jak ją naprawić i jakie ma źródło, a każdą tabelę można wyeksportować do CSV lub Excela dla dewelopera, który poprawi szablon. Neova uruchamia wszystkie 694 testów w każdym planie, także Free:
| Neova | |
|---|---|
| Działa na | |
| Testy | 694 |
| Darmowy plan | 1000 adresów URL na crawl |
| Języki interfejsu | 15 |
Mac oznacza Apple silicon; w przeglądarce działa Neova Online, z tym samym kontem. Zobacz Funkcje, Cennik albo pobierz Neova.
Pytania
Czym jest narzędzie do sprawdzania hreflang?
To narzędzie, które czyta tagi hreflang witryny i porównuje je ze sobą: poprawne kody języka i regionu, odwołania do siebie, linki zwrotne, x-default oraz to, czy każdy cel odpowiada 200, jest indeksowalny i jest swoim własnym canonicalem.
Czym są linki zwrotne hreflang?
Jeśli strona A wymienia stronę B jako alternatywną, strona B musi też wymieniać stronę A. Google pisze, że gdy dwie strony nie wskazują się nawzajem, ich tagi hreflang mogą zostać zignorowane.
Czy x-default jest wymagany?
Nie, jest opcjonalny. Zaleca się go dla stron wyboru języka, stron głównych i stron, które przekierowują odwiedzających według języka lub lokalizacji, aby wyszukiwarki wiedziały, którą wersję pokazać, gdy nic innego nie pasuje.
Użyć en-uk czy en-gb?
en-gb. Część regionalna to dwuliterowy kod kraju ISO 3166-1 Alpha 2, a kod Wielkiej Brytanii to GB. en-uk nie jest poprawną wartością. Więcej takich odpowiedzi znajdziesz w FAQ o hreflang i SEO międzynarodowym na SEO ProCheck.
Która metoda hreflang jest najlepsza?
Dla Google działa każda z trzech: tagi link w head HTML, nagłówek HTTP Link lub mapa strony XML. Używaj jednej metody na zestaw. Tagi link najłatwiej sprawdzić, nagłówek pasuje do PDF-ów, a mapy stron trzymają duże zestawy poza stroną.