Генератор hreflang: теги, карта сайта и заголовок для языков

Как пользоваться

Введите по одной строке на языковую версию в поле Языковые версии: код, вертикальную черту и полный адрес.
Если у вас есть выбор языка или страница по умолчанию, введите её адрес в поле Адрес по умолчанию (x-default).
Прочитайте Проверка строк. Когда там написано, что все версии верны, скопируйте элементы link, карту сайта или заголовок.
Поставьте один и тот же набор на каждую страницу и проверьте, что каждая версия ссылается на все остальные.

Как проверяются коды

Часть языка должна быть двухбуквенным кодом ISO 639-1: в списке Библиотеки Конгресса их 183. Необязательный регион должен быть официально присвоенным кодом ISO 3166-1 alpha-2, например GB или TW. По руководству Google поддерживаются только эти два стандарта, и язык идёт первым, поэтому голый регион вроде GB не принимается.

Часть письменности, например Hant или Hans, должна состоять из четырёх букв. По руководству Google письменности задаются по ISO 15924; этот инструмент проверяет форму письменности, а не полный список. Коды не чувствительны к регистру, поэтому инструмент пишет язык строчными буквами, регион — заглавными, письменность — с заглавной первой буквы.

en-uk не принимается, потому что UK — зарезервированный код; у Соединённого Королевства код GB, поэтому инструмент предлагает en-GB.
iw, in и ji в 1989 году заменены на he, id и yi, поэтому инструмент предлагает эти коды.
Коды, которым ничего не соответствует, например xx, eng или en_US, отклоняются с указанием номера строки.

Три способа передать один набор

Google перечисляет три способа: элементы link в HTML-голове, заголовки HTTP и XML-карту сайта. Google называет их равнозначными, поэтому выбирайте тот, который легче поддерживать. Форма карты сайта требует пространства имён xhtml, и каждая запись url перечисляет все альтернативы, включая себя.

Способ с заголовком HTTP описан для ответа GET любой страницы; Google называет его полезным для файлов, не являющихся HTML, например PDF, и его примеры — это PDF. Для веб-страницы обычный выбор — элементы link или карта сайта. Google также указывает, что заголовок Link, который возвращается для каждой версии страницы, одинаков, поэтому инструмент пишет одно значение для всего набора.

Обратные ссылки и x-default

Каждая версия должна перечислять себя и все остальные версии, и каждая страница должна ссылаться обратно. Google пишет: «Если две страницы не ссылаются друг на друга, теги будут проигнорированы». Когда набор трудно поддерживать полным, Google разрешает опустить некоторые языки на некоторых страницах, и пары, которые ссылаются друг на друга, всё равно обрабатываются.

x-default — страница-запасной вариант для языков, которые не совпадают ни с одной из ваших версий. Google рекомендует его для страниц выбора языка; пишется он без кода языка.

Разбор примера: три версии и запасной вариант

Строки en | https://example.com/en/, en-GB | https://example.com/en-gb/ и tr | https://example.com/tr/ с https://example.com/ как запасным вариантом дают четыре альтернативы. Каждая страница набора получает одни и те же четыре элемента link, а в карте сайта по одной записи url на каждую из трёх страниц.

Каждая запись url перечисляет все четыре альтернативы. Строка проверки читается так: «Языковых версий: 3, все верны», потому что запасной вариант не является языковой версией.

Вывод	Количество	Подробности
Элементы link	4	hreflang="tr" href="https://example.com/tr/"
Записи url в карте сайта	3	каждая перечисляет 4 альтернативы, включая x-default
Значения заголовка Link	1	одно и то же значение на каждой странице, с 4 альтернативами
Языковые версии	3	проверка: языковых версий 3, все верны

Частые вопросы

Какие коды правильны?

Код языка из ISO 639-1, например en, tr или zh, может сопровождаться четырёхбуквенной письменностью, например Hant, и регионом по ISO 3166-1, например GB или TW. Коды не чувствительны к регистру, и инструмент записывает их в стандартном написании.

Почему en-uk считается ошибкой?

UK — зарезервированный код в ISO 3166-1, а руководство Google говорит, что UK в hreflang не действует. Присвоенный код Соединённого Королевства — GB, поэтому верный тег — en-GB.

Нужна ли строка x-default?

Нет, она необязательна. Google называет x-default запасным вариантом для языков, которые не совпадают ни с одной из ваших версий, и рекомендует его для выбора языка. Инструмент добавляет её, только если вы ввели адрес.

Должна ли каждая страница перечислять весь набор?

Каждая версия должна перечислять себя и все остальные версии. Google говорит, что теги игнорируются, если две страницы не ссылаются друг на друга, а также что язык можно опустить на некоторых страницах: пары, которые ссылаются друг на друга, всё равно обрабатываются.

Почему инструмент принимает только адреса https?

Он принимает абсолютные адреса https, которые сейчас использует большинство сайтов. Google требует полные адреса с указанием протокола, поэтому сайт, который ещё работает по обычному http, нужно размечать вручную.

Предназначен ли способ с заголовком HTTP для веб-страниц?

Google описывает его для ответа GET любой страницы и называет полезным для файлов, не являющихся HTML, например PDF. Для веб-страниц обычно выбирают элементы link или карту сайта.

Отправляет ли инструмент мои адреса куда-нибудь?

Нет. Результат собирается в вашем браузере из введённого текста, и ничего не отправляется на сервер.

Источники

Цифры и текст в последний раз проверены вторник, 10 ноября 2026 г..

Результат