Как настроить hreflang для мультиязычного сайта
Коротко
Настройка hreflang сводится к четырем действиям: составить карту языковых версий, выбрать коды языка и страны по ISO, разместить на каждой версии теги со ссылками на все версии и на себя, затем проверить взаимность ссылок и canonical. Для яндекса разметку ставят в HTML, карту сайта он для языковых версий больше не читает.
Когда у сайта появляется вторая языковая версия, поисковик видит несколько похожих по смыслу страниц и сам решает, какую из них показать человеку. Без подсказки англоязычный пользователь может попасть на русскую страницу, а русская версия начнет спорить за показы с белорусской. Настройка hreflang снимает эту путаницу: разметка связывает версии одной страницы между собой и сообщает, для какого языка и какой страны предназначена каждая.
Ниже порядок работ, по которому разметку можно внедрить без ошибок и потом проверить своими силами: от карты версий и кодов ISO до выбора способа под гугл и яндекс, тонкостей WordPress и связки с canonical.
Когда разметка нужна, а когда без нее можно обойтись
Разметка нужна, если одна и та же страница существует в нескольких языковых или региональных вариантах. Яндекс в справке называет три таких случая: полный перевод страницы, версия на том же языке с небольшими региональными отличиями (цены, контакты, доставка) и страница, где на другой язык переведен только шаблон, то есть меню и подвал, а основной текст общий.
Обойтись без нее можно, если у сайта один язык и одна целевая страна или если тексты на разных языках не являются переводами друг друга. Например, англоязычный раздел с собственными темами, у которых нет русских аналогов: связывать там нечего, и разметка ничего не даст.
Еще одна граница: hreflang не заменяет перевод. Разметка указывает, какая страница для какой аудитории, но язык поисковик определяет по самому тексту. Страница, где под отметкой английской версии половина абзацев осталась на русском, для поисковика останется смешанной, и никакие теги это не исправят.
Типичная ситуация для компаний из Беларуси: русская версия для своего рынка, английская для зарубежных клиентов и иногда белорусская. Здесь разметка полезна с первого дня, потому что без нее по запросу на русском поисковик может показать любую версию, которую сочтет более сильной, в том числе английскую.
Соберите карту языковых версий до того, как писать код
Начинать стоит с таблицы соответствия, а не с тегов: в строке одна страница, в колонках ее адреса на каждом языке. Теги потом выводятся из этой таблицы или из связей переводов в админке, и ошибиться в них сложнее, чем при ручной правке шаблона.

Таблица сразу показывает три вещи, которые в шаблоне не видны. Первая: страницы без пары, например статья есть только на русском, а услуга только на английском. Для них связь не ставится вовсе или ставится только между теми версиями, которые существуют. Вторая: страницы с разными адресами одного смысла, вроде /ru/uslugi/ и /en/services/; они должны оказаться в одной строке, даже если slug переведен. Третья: адреса, которые закрыты от индексации или отдают редирект; в разметку они попадать не должны.
Отдельно решите, что будет x-default. Так обозначают версию для людей, чей язык не совпадает ни с одной из отмеченных: страницу выбора языка или основную версию, чаще английскую. Как устроить адреса версий и что держать в корне домена, мы разобрали в статье о выборе между доменами, подпапками и поддоменами, карта версий опирается на это решение.
Частая картина в такой таблице: английских страниц заметно меньше, чем русских, потому что сначала перевели только главную и услуги. Это нормально, версии не обязаны совпадать один к одному. Требование другое: каждая связь, которая есть в таблице, должна быть взаимной, и таблицу нужно обновлять при каждом новом переводе.
Коды языков и стран: где ошибаются чаще всего
Язык указывают двухбуквенным кодом по ISO 639-1, страну при необходимости добавляют через дефис кодом по ISO 3166-1 Alpha-2: en, en-GB, ru-BY. Страну без языка указать нельзя, а одиночный код всегда читается как язык. Гугл в документации приводит пример, который касается и нас: be означает белорусский язык, а не Бельгию.
Для сайтов, которые работают на Беларусь, Россию, Казахстан и Украину, путаница встречается особенно часто, потому что коды языка и страны у этих стран не совпадают. Сверяться удобно по таблице:
| Что нужно указать | Правильно | Частая ошибка | Почему ошибка |
|---|---|---|---|
| Белорусский язык | be | by | by это код страны, а не языка |
| Русский язык для Беларуси | ru-BY | BY | страну без языка указать нельзя |
| Украинский язык | uk | ua | ua это код страны, язык обозначается uk |
| Казахский язык | kk | kz | kz это код страны |
| Английский для Великобритании | en-GB | en-UK | UK зарезервированный код, гугл его игнорирует |
| Английский для Европы в целом | en | en-EU | EU не код страны, гугл его тоже игнорирует |
| Испанский для Латинской Америки | es или коды отдельных стран | es-419 | гугл такие региональные коды не поддерживает |
Регистр букв значения не имеет, но по традиции язык пишут строчными, а страну заглавными. Яндекс в справке допускает для регионов России коды по ISO 3166-2:RU. В документации гугла о них ничего нет, поэтому для сайта, которому важны оба поисковика, надежнее оставаться на уровне страны.
Страну добавляют, только когда версии действительно различаются для разных стран: ценами, валютой, доставкой, контактами. Если английская версия одна для всех, достаточно кода en, и поисковик сможет показывать ее англоязычным людям в любой стране. Код en-US для единственной английской версии сообщает поисковику более узкую аудиторию, чем есть на самом деле.
Три способа разметки и почему для яндекса подходит один
Связи между версиями задают тегами link в head страницы, HTTP-заголовком Link в ответе сервера или в карте сайта через элементы xhtml:link. По документации гугла о локализованных версиях эти способы для него равноценны, а использовать все три сразу смысла нет, дополнительной пользы для поиска это не дает.
У яндекса картина другая. В справке Вебмастера о локализованных страницах сказано, что карту сайта для языковых версий он больше не поддерживает, и рекомендуемым способом названа разметка в коде страницы. Многие руководства до сих пор советуют sitemap как самый удобный вариант для больших сайтов. Для гугла это верно, но если сайт продвигается и в яндексе, связи из карты сайта он не учтет.
Выбор способа зависит от того, какие поисковики важны и какие файлы лежат на сайте:
- рынки, где работают и гугл, и яндекс: теги в head на всех HTML-страницах;
- только гугл и десятки тысяч страниц: карта сайта, так проще поддерживать разметку и head не разрастается;
- PDF и другие файлы без head: HTTP-заголовок Link;
- переход с карты сайта на теги: сначала добавить теги и проверить их, потом убрать блоки из карты, чтобы два источника не расходились.
Если по историческим причинам разметка стоит и в карте сайта, и в коде, следите, чтобы наборы совпадали. Два разных списка связей для одной страницы хуже, чем один правильный: поисковику приходится выбирать, какому верить.
Пошаговая установка тегов на примере трех версий
Каждая версия страницы перечисляет в head все версии, включая саму себя, и этот набор одинаков на всех версиях. Для страницы услуги на русском для Беларуси, на английском и на белорусском, с английской версией в роли x-default, блок в head выглядит так:
<link rel=»alternate» hreflang=»ru-BY» href=»https://site.by/ru/uslugi/seo/» />
<link rel=»alternate» hreflang=»be» href=»https://site.by/be/paslugi/seo/» />
<link rel=»alternate» hreflang=»en» href=»https://site.by/en/services/seo/» />
<link rel=»alternate» hreflang=»x-default» href=»https://site.by/en/services/seo/» />
Точно такие же четыре строки стоят на всех трех страницах. Порядок работ для всего сайта такой:
- Выгрузите список индексируемых страниц каждой версии и сведите его в таблицу соответствия.
- Определите коды для каждой версии и страницу для x-default.
- Настройте вывод тегов в шаблоне из таблицы или из связей переводов в админке, полными адресами с https.
- Проверьте, что каждая страница ссылается на себя и что у каждой связи есть ответная.
- Убедитесь, что все адреса в разметке отдают ответ 200, открыты для индексации и указывают canonical сами на себя.
- Повторяйте проверку после каждого изменения адресов, переводов или шаблона.
Адреса указывают полностью, с протоколом и доменом, относительные пути вида /en/ не годятся. Версии могут лежать на разных доменах, это разрешено, но тогда разметку придется поддерживать на обоих сайтах синхронно, и любое изменение адреса на одном домене нужно сразу отражать на другом.
Теги должны стоять внутри корректного head. Если выше них в head оказался элемент, которому там не место, например картинка или iframe от счетчика или виджета, поисковик может решить, что head закончился раньше, и разметку не увидит. Поэтому после установки смотрят не только на наличие тегов, но и на то, что стоит перед ними в коде.
WordPress и Polylang: что плагин делает сам, а что нет
На WordPress с Polylang теги обычно не пишут руками: плагин сам выводит их в head для записей и страниц, у которых связаны переводы. Поэтому главная работа по настройке hreflang на таком сайте не в коде, а в том, чтобы переводы в админке были связаны правильно и полностью.
Отсюда три проверки. Первая: у каждой переведенной записи в колонке языков стоит связь с переводом, а не создана отдельная запись без привязки. Несвязанная копия получает свою страницу без разметки, и для поисковика она выглядит самостоятельной. Вторая: x-default. По документации Polylang плагин добавляет его только для главной страницы; если вариант по умолчанию нужен и на внутренних страницах, его подключают фильтром pll_rel_hreflang_attributes. Такую правку стоит поручить разработчику и сначала проверить на тестовой копии сайта.
Третья проверка касается других плагинов и темы. Если разметку выводят одновременно Polylang, SEO-плагин и сама тема, в коде появляются повторяющиеся теги, иногда с разными адресами для одного кода. Достаточно открыть исходный код любой переведенной страницы и посчитать строки с hreflang: их должно быть столько, сколько версий, плюс одна для x-default, если она есть.
Остальные базовые настройки движка, от постоянных ссылок до карты сайта, мы собрали в материале про SEO для WordPress без лишних плагинов. С этого списка удобно начинать проверку многоязычного сайта на этом движке, а языковую разметку сверять уже после него.
Связка с canonical, редиректами и noindex
Разметка языков и canonical не мешают друг другу, если каждая версия указывает canonical на саму себя. Проблема появляется, когда все версии ставят canonical на основную, например на русскую. Поисковик получает противоречивые сигналы: одна разметка говорит, что это отдельная версия для другой аудитории, другая говорит, что это копия. Переводы в такой ситуации рискуют остаться вне индекса.
С редиректами похожая история. В разметке должны стоять конечные адреса с ответом 200. Если ссылка ведет на редирект, даже на технический, вроде добавления слеша в конце адреса, связь становится ненадежной. Страницы под noindex тоже не стоит связывать: закрытая версия в выдачу не попадет, и ссылка на нее только засоряет набор.
Отдельный вопрос: автоматическая переадресация по языку браузера или IP. Гугл советует так не делать. Его робот обычно приходит из США и без заголовка Accept-Language, поэтому при такой переадресации он может так и не увидеть часть версий. Надежнее показать заметный переключатель языка на каждой странице, а подходящую версию предложить плашкой, оставив выбор человеку.
Последний случай: версии на одном языке для разных стран, например ru-BY и ru-RU с почти одинаковым текстом. Гугл может сгруппировать такие страницы и выбрать одну каноническую, а разметка в этом случае помогает подставить в выдачу нужный адрес. Чтобы обе версии индексировались самостоятельно, им нужны реальные различия: цены и валюта, контакты, условия доставки, местные примеры. Как сделать версию под страну адаптацией, а не копией, разобрано в статье о том, как локализовать контент под другую страну.
Как проверить разметку после запуска
Проверять разметку придется самостоятельно: отдельного отчета об ошибках hreflang в консоли гугла нет с 2022 года, когда убрали отчет о международном таргетинге. Снаружи ошибки не видны: сломанная связь просто перестает работать, а сайт при этом открывается как обычно.

Удобнее всего пройти сайт краулером, который читает hreflang, и сверить результат с таблицей соответствия. В выгрузке смотрят на семь вещей:
- у каждой страницы есть ссылка на саму себя;
- у каждой связи есть ответная, без нее гугл связь игнорирует;
- все адреса в разметке отдают 200, без редиректов и noindex;
- canonical каждой версии указывает на нее же;
- коды языков и стран взяты из стандартов ISO, без UK, EU и кодов стран вместо языка;
- на одной странице нет двух тегов с одинаковым кодом и разными адресами;
- x-default указан один раз и ведет на существующую страницу.
После краулера откройте по две-три страницы каждого типа в каждой версии и посмотрите исходный код вручную. Шаблоны статей, услуг и категорий иногда выводят разметку по-разному, и краулер со стандартными настройками может пройти не все типы страниц.
Через несколько недель полезно заглянуть в отчет об эффективности в консоли гугла и сравнить показы по странам и адресам разделов. Если англоязычная версия начала собирать показы в странах, где раньше показывалась русская, это признак, что поисковик понял связи. Если ничего не поменялось, возвращайтесь к списку выше и проверяйте взаимность ссылок и canonical.
Итог: с чего начать на этой неделе
Настройку hreflang начинают с таблицы соответствия версий, а не с кода. Дальше выбирают коды по ISO и страницу x-default, ставят теги в head (для сайтов, которым важен яндекс, это единственный рабочий способ), проверяют, что canonical каждой версии указывает на нее саму, и проходят сайт краулером по списку из семи пунктов. Повторную проверку закладывайте в каждое изменение структуры: новый перевод, смена адресов или шаблона легко ломают связи, которые работали вчера.
Если сайт выходит на новые рынки и с языковыми версиями нужна помощь, загляните на страницу о международном SEO и оставьте заявку: проверим разметку и структуру версий, подскажем, для каких языков и стран нужны отдельные версии, и предложим порядок работ под ваш сайт.
Читайте по теме: Выход на рынок ОАЭ через поиск: языки, гугл и локальная специфика
Частые вопросы
Сколько времени нужно, чтобы поисковик учел hreflang?
Точного срока нет: разметка начинает работать после того, как робот заново обойдет все связанные версии страницы. Для часто посещаемых страниц это могут быть дни, для глубоких разделов недели. Ускорить процесс может отправка обновленной карты сайта и проверка ключевых адресов в консоли гугла и Вебмастере после изменений.
Влияет ли hreflang на позиции сайта?
Нет, напрямую позиции эта разметка не поднимает. Она помогает поисковику показать человеку версию страницы на его языке и для его страны вместо соседней. Косвенная польза в том, что из выдачи приходят люди, которые читают на языке страницы, а языковые версии меньше конкурируют между собой за одни и те же показы.
Можно ли ссылаться на главную, если перевода страницы нет?
Нет, в hreflang указывают только перевод или региональный вариант той же самой страницы. Ссылка с услуги на главную английской версии создает ложную связь, и пользы она не принесет. Если перевода нет, у страницы просто не будет пары, а переход на другую версию сайта дайте переключателем языка в шапке.
Чем атрибут lang отличается от hreflang?
Главное отличие в задаче: атрибут lang в теге html сообщает браузеру и экранным чтецам язык текущей страницы, а hreflang связывает между собой разные языковые версии. Гугл в документации пишет, что не определяет язык страницы ни по одному из них, он распознает язык по тексту. Поэтому оба атрибута должны совпадать с реальным языком контента.
Нужен ли hreflang для мобильной версии на поддомене?
Нет, hreflang нужен только для языковых и региональных версий. Отдельную мобильную версию на поддомене вроде m.site.by связывают с основной другой разметкой: на десктопной странице ставят rel=alternate с атрибутом media, а на мобильной canonical на десктопную. Если у каждой языковой версии есть мобильный вариант, связи языков строят между адресами одного типа.
