Hreflang
Hreflang — атрибут ссылки rel="alternate", которым сайт сообщает поисковику: у этой страницы есть версии на других языках или для других стран, вот их адреса. По нему Google и Яндекс показывают человеку версию на его языке и для его региона.
Главное правило: набор ссылок должен быть взаимным и одинаковым на всех версиях. Каждая версия ссылается на себя и на все остальные; если страница A указывает на B, а B на A — нет, Google такие указания игнорирует.
Для кого: sEO-специалистам и разработчикам сайтов с несколькими языковыми или региональными версиями.
- Hreflang помогает выбрать версию страницы для показа, но не определяет язык страницы — язык Google определяет сам.
- Значение — код языка по ISO 639-1, после дефиса можно добавить код страны по ISO 3166-1 Alpha-2: ru, en, en-us.
- Код страны без кода языка недопустим.
- x-default — версия для всех, кому не подошла ни одна другая, обычно страница выбора языка.
- Ссылки взаимные, включают саму страницу и указывают полные адреса с протоколом.
- Google принимает hreflang в теге link, HTTP-заголовке и sitemap; Яндекс — в теге link, а sitemap для языковых версий больше не поддерживает.
Ключевые факты
- Синтаксис в HTML
- тег link с rel=alternate, hreflang и href в разделе head
- Код языка и страны
- язык — ISO 639-1, страна — ISO 3166-1 Alpha-2; Яндекс для регионов России принимает ISO 3166-2:RU
- Резервное значение
- x-default — когда ни одна версия не подходит языку и региону пользователя
- Способы в Google
- тег link в head, HTTP-заголовок Link, sitemap — равноценны
- Способы в Яндексе
- тег link в head; sitemap для языковых версий Яндекс больше не поддерживает
Что такое hreflang и когда он нужен
Hreflang — атрибут ссылки rel="alternate", который связывает версии одной страницы на разных языках или для разных стран. Он говорит поисковику: «вот эта же страница по-английски, вот версия для Казахстана». Поисковик выбирает из связанных версий ту, что подходит языку и региону человека.
Hreflang нужен в трёх случаях:
- разные языки — русская и английская версии сайта;
- один язык, разные страны — версии для России и Казахстана с разными ценами и доставкой;
- страница выбора языка — общая точка входа для всех остальных.
По справке Яндекса, атрибут уместен и для полного перевода, и для страниц с небольшими отличиями, и для страниц, которые отличаются только шаблоном. Без hreflang поисковик может показать человеку не ту версию, а версии на одном языке для разных стран — принять за дубли. Подробно о дублях — в статье «Дубли страниц».
Важная оговорка Google: hreflang не определяет язык страницы. По справке, ни hreflang, ни атрибут lang Google для этого не использует — язык он определяет по содержимому. Hreflang помогает выбрать версию для показа.
Hreflang — часть технической настройки сайта; общий порядок проверки — в опорной статье «Техническое SEO».
Синтаксис: код языка и региона
Базовая запись в разделе head:
<link rel="alternate" hreflang="ru" href="https://example.com/ru/page/" />Значение hreflang собирают из двух частей:
| Часть | Стандарт | Примеры | Обязательна |
|---|---|---|---|
| Язык | ISO 639-1 | ru, en, de, kk | да |
| Страна | ISO 3166-1 Alpha-2 | us, gb, kz, by | нет |
Правила по справке Google:
- Сначала язык, потом страна через дефис:
en-gb,ru-kz. - Страна без языка недопустима. Запись
hreflang="kz"— ошибка: это код страны, а не языка. - Зарезервированные коды не работают.
EU,UNиUKGoogle не учитывает. Для Великобритании код страны —GB. - Регистр не важен. Код страны принято писать заглавными по стандарту ISO, но Google понимает и строчные.
- Можно указать письменность:
zh-Hantиzh-Hansдля традиционного и упрощённого китайского. - Адрес — полный, с протоколом:
https://example.com/en/, а не/en/.
У Яндекса есть важное отличие: для регионов России он принимает коды по ISO 3166-2:RU, а для стран — ISO 3166-1 Alpha-2. Кроме того, Яндекс поддерживает ограниченный список языков — в справке Вебмастера их около сорока, проверьте свой язык там.
x-default: версия по умолчанию
x-default — зарезервированное значение для версии, которую показывают, если язык и регион человека не совпали ни с одной из указанных:
<link rel="alternate" hreflang="x-default" href="https://example.com/" />Google рекомендует ставить x-default на страницу выбора языка. Яндекс описывает его как значение для страницы, где язык определяется автоматически — по IP-адресу или заголовку Accept-Language — или выбирается на сайте. Обе трактовки сходятся: x-default — общая точка входа, а не одна из локализованных версий.
Если такой страницы нет, x-default можно поставить на версию, которую вы считаете основной для остального мира, — по моему опыту, чаще всего это английская.
Взаимные ссылки: главное правило
Набор ссылок hreflang должен быть:
- полным — каждая версия перечисляет все версии, включая саму себя;
- одинаковым — на всех версиях один и тот же набор;
- взаимным — если A ссылается на B, то B ссылается на A.
Google пишет прямо: если две страницы не ссылаются друг на друга, указания игнорируются. Пример для трёх версий — этот блок стоит на всех трёх страницах без изменений:
<link rel="alternate" hreflang="ru" href="https://example.com/ru/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />Версии не обязаны лежать на одном домене. Google допускает альтернативные адреса на других доменах, а Яндекс пишет, что версии могут быть в каталогах, на поддоменах или разных доменах — структура сайта на обработку hreflang не влияет.
Отдельно — canonical. Он работает внутри одной языковой версии, а hreflang связывает версии между собой. Google советует указывать канонический адрес на том же языке. Частая ошибка — поставить canonical всех версий на русскую: тогда остальные версии становятся неканоническими, и связка ломается. Ещё одна тонкость: ссылки rel="canonical" с атрибутом hreflang Google при выборе канонического адреса не использует.
Ссылки hreflang должны вести на страницы с кодом ответа 200 — не на редиректы и не на 404. После смены адресов, например при переходе на HTTPS, hreflang переписывают вместе с canonical и sitemap.
Способы указать hreflang: link, заголовки, sitemap
| Способ | Яндекс | Когда удобен | |
|---|---|---|---|
Тег link в head | да | да, основной способ | обычные HTML-страницы |
HTTP-заголовок Link | да | в справке не описан | PDF и другие файлы без head |
| Sitemap | да | больше не поддерживается | много версий, нет доступа к шаблону |
Google считает три способа равноценными — достаточно одного.
HTTP-заголовок. Записи перечисляют через запятую:
Link: <https://example.com/ru/file.pdf>; rel="alternate"; hreflang="ru", <https://example.com/en/file.pdf>; rel="alternate"; hreflang="en"Sitemap. Внутри каждого элемента url — адрес в loc и элементы xhtml:link для каждой версии, включая саму страницу. Такой способ удобен для больших сайтов, но работает только для Google: Яндекс, по его справке, файл Sitemap для языковых версий больше не поддерживает и рекомендует тег link.
Поэтому для сайта, который продвигается в обоих поисковиках, я ставлю hreflang в head — его понимают и Google, и Яндекс.
Как проверить hreflang
Проверка сводится к трём вопросам:
- Есть ли набор на каждой версии. Краулером соберите все теги hreflang по сайту.
- Взаимны ли ссылки. Для каждой пары A и B проверьте обратную ссылку.
- Отвечают ли адреса кодом 200 и каноничны ли они. Ссылка на редирект, 404 или неканоническую страницу — ошибка. Код ответа отдельного адреса покажет проверка ответа сервера.
Ошибки, которые я встречаю чаще всего:
| Ошибка | Чем грозит | Как исправить |
|---|---|---|
| Нет обратной ссылки | Google игнорирует пару версий | один общий блок hreflang на всех версиях |
Код страны без языка (kz, us) | запись не работает | добавить язык: ru-kz, en-us |
| Относительные адреса | Google ждёт полный адрес с протоколом | писать https:// и домен |
| Canonical на версию на другом языке | версии выпадают из связки | canonical каждой версии — на себя |
| Ссылки на старые адреса после переезда | ссылки ведут на редиректы | обновить hreflang вместе с canonical и sitemap |
| Hreflang только в sitemap | Яндекс его не увидит | продублировать тегом link в head |
Большинство этих ошибок появляется не при первой настройке, а позже: добавили новую версию, но забыли обновить остальные, сменили структуру адресов, перенесли сайт на другую CMS. Поэтому hreflang стоит проверять после каждого переезда сайта и при добавлении нового языка.
Отдельно сверьте коды: нет ли записей вроде uk в значении Великобритании — это код украинского языка — и кодов страны без языка. Если версии сделаны для регионов, проверьте и региональные настройки: как Яндекс определяет регион сайта, разобрано в статье «Регион сайта в Яндексе».
Как настроить hreflang
- 1
Составьте карту версий
Для каждой страницы выпишите все её версии: язык, страна, полный адрес. Версии без перевода или без пары не включайте.
- 2
Выберите коды
Язык — по ISO 639-1 (ru, en, de), страна — по ISO 3166-1 Alpha-2 (us, gb, kz). Код страны без языка не используйте.
- 3
Добавьте x-default
Если есть страница выбора языка или версия с автоопределением, укажите её как x-default.
- 4
Разместите ссылки
Добавьте в head каждой версии полный набор тегов link с rel=alternate и hreflang — включая ссылку на саму страницу. Для Google можно вместо этого использовать sitemap или HTTP-заголовки.
- 5
Проверьте взаимность и canonical
Краулером сравните наборы ссылок на всех версиях. Canonical каждой версии должен указывать на саму эту версию, а не на версию на другом языке.
Частые ошибки
- Ссылаться на другие версии без обратных ссылок — Google игнорирует невзаимные указания.
- Указывать только код страны, например hreflang=«us» вместо «en-us».
- Использовать коды вроде UK или EU — у Google они не работают; для Великобритании код страны — GB.
- Писать относительные адреса вместо полных с https.
- Ставить canonical всех языковых версий на одну главную.
- Рассчитывать на sitemap с hreflang в Яндексе — он его больше не поддерживает.
Вопросы о hreflang
Что такое hreflang простыми словами?
Hreflang простыми словами — подсказка поисковику в коде страницы: «эта же страница есть на английском — вот адрес, а для Казахстана — вот этот». По ней Google и Яндекс показывают в выдаче версию на языке и для региона человека.
Когда нужен hreflang?
Hreflang нужен, когда у страницы есть версии на разных языках или для разных стран на одном языке — например, ru для России и ru-kz для Казахстана. По справке Яндекса, атрибут уместен и для полных переводов, и для версий с небольшими отличиями.
Что такое hreflang x-default?
Hreflang x-default — резервная версия страницы: её показывают, если язык и регион пользователя не совпали ни с одной из указанных версий. Google рекомендует ставить x-default на страницу выбора языка, Яндекс — на страницу, где язык определяется автоматически.
Как правильно записать код в hreflang?
Код в hreflang записывают так: сначала язык по ISO 639-1, затем через дефис — необязательный код страны по ISO 3166-1 Alpha-2. Примеры — ru, en, en-us, de-at. Один код страны без языка недопустим, а регистр букв для Google не важен.
Нужно ли указывать в hreflang ссылку на саму страницу?
Ссылку на саму страницу в hreflang указывать нужно: по справке Google, каждая версия перечисляет себя и все остальные версии, и этот набор одинаков на всех страницах.
Что будет, если ссылки hreflang не взаимные?
Если ссылки hreflang не взаимные, Google их игнорирует: когда две страницы не ссылаются друг на друга, указания между ними не учитываются. Это самая частая ошибка в настройке hreflang.
Можно ли указать hreflang в sitemap?
Указать hreflang в sitemap можно для Google: это один из трёх равноценных способов наряду с тегом link и HTTP-заголовком. Яндекс, по его справке, sitemap для языковых версий больше не поддерживает — для него нужен тег link в head.
Как связаны hreflang и canonical?
Hreflang и canonical работают вместе: canonical указывает главный адрес внутри одной языковой версии, а hreflang связывает версии между собой. Google советует ставить canonical на страницу на том же языке; canonical со ссылкой на другую языковую версию ломает связку.
Определяет ли Google язык страницы по hreflang?
Язык страницы Google по hreflang не определяет: в справке сказано, что ни hreflang, ни атрибут lang для этого не используются. Google определяет язык по содержимому, а hreflang помогает выбрать, какую из версий показать.
Должны ли языковые версии быть на одном домене?
Языковые версии не обязаны быть на одном домене: Google допускает альтернативные адреса на других доменах, а Яндекс пишет, что версии могут быть на поддоменах, доменах или в каталогах — структура сайта на обработку hreflang не влияет.
Обсудим ваш проект?
Напишите, что за сайт и какая задача — отвечу сам, обычно в течение дня.