Jak używać
- Dodaj osobny wiersz dla każdej wersji językowej lub regionalnej: wpisz kod (np. de lub de-AT) i pełny URL tej wersji zaczynający się od https://.
- Opcjonalnie dodaj URL x-default dla użytkowników, których języka nie uwzględniono.
- Popraw błędy wyświetlone przy wierszach, a następnie wybierz znaczniki HTML, wpisy w mapie witryny XML lub nagłówek HTTP.
- Skopiuj kod i dodaj ten sam zestaw do każdej wymienionej strony, tak aby każda strona zawierała wszystkie wersje, również samą siebie.
Jak to działa
hreflang informuje wyszukiwarki, które adresy URL prowadzą do wersji tej samej treści w różnych językach lub dla różnych regionów. Dzięki temu na przykład osobie wyszukującej w Austrii można wyświetlić stronę de-AT zamiast de-DE. Wartość to kod języka ISO 639-1, opcjonalnie uzupełniony dwuliterowym kodem regionu ISO 3166-1 alpha-2; sam kod regionu (np. „GB”) jest nieprawidłowy. Narzędzie wykrywa typowe błędy, takie jak en-UK (prawidłowy kod to en-GB), regiony niebędące krajami, np. EU, oraz zduplikowane kody. Kody są sprawdzane na podstawie danych o językach i regionach wbudowanych w przeglądarkę.
Adnotacje muszą być dwukierunkowe i wzajemnie się wskazywać: każda strona w zestawie musi zawierać odnośniki do wszystkich wersji, w tym do samej siebie. Jeśli strona niemiecka wskazuje stronę francuską, ale francuska nie wskazuje z powrotem niemieckiej, wyszukiwarki mogą zignorować tę parę. x-default oznacza stronę domyślną dla pozostałych użytkowników. Używaj bezwzględnych adresów URL i kieruj każdy wpis hreflang do kanonicznej wersji danej strony, a nie do przekierowania ani strony z tagiem noindex.
Adnotacje można opublikować na trzy równoważne sposoby: za pomocą elementów link w sekcji head dokumentu HTML, wpisów xhtml:link w mapie witryny XML lub nagłówka HTTP Link. Wybierz jedną metodę dla danego zestawu stron; nie ma potrzeby używania więcej niż jednej. hreflang to wskazówka ułatwiająca wybór wersji, a nie sposób na poprawę pozycji w rankingu.
Przykłady
Witryna angielsko-niemiecka
Wiersze en → https://example.com/ i de → https://example.com/de/ oraz x-default → https://example.com/ tworzą trzy tagi link. Zarówno strona angielska, jak i niemiecka muszą zawierać wszystkie trzy.
Hiszpański w Hiszpanii i Meksyku
Użyj es-ES i es-MX dla dwóch wersji regionalnych, a także dodaj ogólną wersję es (lub przypisz do niej jeden z tych wariantów), aby uwzględnić również hiszpańskojęzycznych użytkowników z innych krajów.
Poprawianie typowego błędu
Wykryto nieprawidłowy kod en-UK: UK nie jest kodem ISO 3166-1 dla Zjednoczonego Królestwa. Zmień go na en-GB.
Często zadawane pytania
Czy potrzebuję x-default?
Jest opcjonalny, ale zalecany. Informuje wyszukiwarki, którą stronę wyświetlić, gdy język lub region użytkownika nie pasuje do żadnego z podanych, na przykład globalną stronę angielską lub selektor języka.
Czy mogę użyć regionu bez języka, np. hreflang="us"?
Nie. Język jest wymagany, a region opcjonalny. „us” nie jest kodem języka. Użyj en-US.
Czy używać tagów HTML, czy mapy witryny?
Oba rozwiązania są poprawne. Tagi HTML są najprostsze w przypadku małych witryn. Mapy witryn pozwalają ograniczyć rozmiar kodu HTML strony i ułatwiają zarządzanie wieloma językami. Nagłówków HTTP używa się głównie w przypadku plików PDF i innych plików niebędących dokumentami HTML.
Czy dwa kody językowe mogą wskazywać ten sam URL?
Tak. Na przykład en-GB i en-IE mogą wskazywać tę samą stronę w brytyjskiej wersji językowej. Niedozwolone jest natomiast wskazanie dwóch różnych URL-i tym samym kodem.
Prywatność
Kody i URL-e są sprawdzane i formatowane w przeglądarce. Żadne dane nie są wysyłane ani przechowywane.