Настройка hreflang для мультирегионального SEO
Hreflang — атрибут для указания языковых и региональных версий страницы. Без него Google показывает нерелевантные версии: русскоязычным пользователям из Казахстана — украинскую версию, а пользователям из Германии — английскую вместо немецкой. Правильная настройка требует понимания нескольких неочевидных нюансов.
Синтаксис и варианты реализации
Тег задаётся тремя способами: через <link> в <head>, через HTTP-заголовок Link, или через XML Sitemap. Для HTML-страниц стандартный вариант — теги в <head>:
<link rel="alternate" hreflang="ru" href="https://example.com/ru/" />
<link rel="alternate" hreflang="ru-RU" href="https://example.com/ru/" />
<link rel="alternate" hreflang="ru-UA" href="https://example.com/ru-ua/" />
<link rel="alternate" hreflang="ru-KZ" href="https://example.com/ru-kz/" />
<link rel="alternate" hreflang="uk" href="https://example.com/uk/" />
<link rel="alternate" hreflang="en" href="https://example.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
Каждая страница должна ссылаться сама на себя и на все остальные версии. Если страница /ru/about/ не имеет украинской версии — она всё равно должна ссылаться на существующие варианты. x-default — запасной вариант для регионов и языков, под которые нет специфической страницы.
Типичные ошибки в реализации
Несимметричные ссылки. Наиболее частая проблема — страница /ru/about/ объявляет hreflang на /en/about/, но /en/about/ не отвечает взаимностью. Google требует взаимности, иначе сигнал игнорируется.
Неверные языковые коды. Использование ru-ru вместо ru-RU или UA вместо uk — Google отклонит неверные коды. Корректные коды по BCP 47: ru, en, de, uk, fr, pl.
Страницы без x-default. Для сайтов с геоопределением без x-default Googlebot не понимает, какую страницу показывать нерелевантному региону.
Hreflang в пагинации. Если страница /ru/blog/page/2/ имеет hreflang, каждая пагинированная страница должна иметь свои теги — отдельно для каждого языка и той же страницы пагинации.
Реализация в XML Sitemap
Для крупных сайтов поддерживать hreflang в HTML-шаблоне неудобно — удобнее через Sitemap. Формат:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>https://example.com/ru/about/</loc>
<xhtml:link rel="alternate" hreflang="ru" href="https://example.com/ru/about/"/>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/about/"/>
<xhtml:link rel="alternate" hreflang="uk" href="https://example.com/uk/about/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/about/"/>
</url>
<url>
<loc>https://example.com/en/about/</loc>
<xhtml:link rel="alternate" hreflang="ru" href="https://example.com/ru/about/"/>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/about/"/>
<xhtml:link rel="alternate" hreflang="uk" href="https://example.com/uk/about/"/>
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/en/about/"/>
</url>
</urlset>
Ключевое: все версии страницы должны присутствовать в файле sitemap с полным набором xhtml:link.
Автогенерация на сервере
На проектах с 1000+ страниц и несколькими локалями ручное ведение hreflang — источник ошибок. Генерация на уровне приложения:
// Laravel — генерация hreflang для текущей страницы
function generateHreflang(string $routeName, array $params = []): string
{
$locales = ['ru', 'en', 'uk', 'de'];
$html = '';
foreach ($locales as $locale) {
$url = route($routeName, array_merge($params, ['locale' => $locale]));
$html .= sprintf(
'<link rel="alternate" hreflang="%s" href="%s" />' . PHP_EOL,
$locale,
$url
);
}
// x-default — английская версия
$defaultUrl = route($routeName, array_merge($params, ['locale' => 'en']));
$html .= sprintf(
'<link rel="alternate" hreflang="x-default" href="%s" />' . PHP_EOL,
$defaultUrl
);
return $html;
}
Для Next.js с i18n из next.config.js:
// pages/about.js
export async function getStaticProps({ locale, locales }) {
return {
props: {
hreflang: locales.map(l => ({
locale: l,
url: `https://example.com/${l}/about`,
})),
},
};
}
// В компоненте Head:
{hreflang.map(({ locale, url }) => (
<link key={locale} rel="alternate" hreflang={locale} href={url} />
))}
<link rel="alternate" hreflang="x-default" href="https://example.com/en/about" />
Региональное таргетирование vs языковое
Важно разграничивать два сценария:
Только языки — один сайт, разные языковые версии. ru, en, de. Нет регионального таргетирования, Google показывает версию по языку браузера.
Языки + регионы — разный контент для разных стран на одном языке. ru-RU для России, ru-UA для Украины, ru-KZ для Казахстана. Используется когда цены, валюта, условия доставки, телефоны различаются. Требует реальных отличий в контенте — иначе Google может воспринять как дубли.
Смешивать оба подхода на одном сайте возможно: ru как общая русскоязычная версия и ru-RU, ru-KZ как региональные.
Валидация реализации
Проверить корректность можно несколькими инструментами:
Google Search Console — раздел «Интернационализация» показывает ошибки hreflang: несимметричные ссылки, неверные коды, страницы без самоссылки.
Screaming Frog — краулит сайт и проверяет взаимность hreflang между всеми версиями в разделе Internationalisation.
Автоматизированная проверка через Python:
import requests
from lxml import html
def check_hreflang_symmetry(urls: list[str]) -> list[dict]:
hreflang_map = {}
for url in urls:
resp = requests.get(url, timeout=10)
doc = html.fromstring(resp.content)
links = doc.cssselect('link[rel="alternate"][hreflang]')
hreflang_map[url] = {
link.get('hreflang'): link.get('href')
for link in links
}
errors = []
for url, alternates in hreflang_map.items():
for lang, alt_url in alternates.items():
if lang == 'x-default':
continue
if alt_url not in hreflang_map:
errors.append({'url': url, 'issue': f'Target {alt_url} not crawled'})
continue
# Проверка взаимности
reverse = hreflang_map[alt_url]
if url not in reverse.values():
errors.append({
'url': url,
'lang': lang,
'issue': f'{alt_url} does not link back to {url}'
})
return errors
Сроки
Аудит и исправление существующих hreflang для сайта до 500 страниц — 2–3 рабочих дня. Внедрение с нуля, включая генерацию в коде и XML Sitemap — 3–5 дней в зависимости от CMS/фреймворка. Для сайтов с нестандартной структурой URL (субдомены по регионам, ccTLD) добавляется 1–2 дня на тестирование.