Hreflang використовує недійсний код мови або системи письма

У звітіHreflang language code invalid

hreflang_invalid_language_code · Проблема

Коротка відповідь

Мовна анотація використовує код чи формат поза підтримуваним профілем hreflang. Виправте зафіксовану анотацію в її джерелі.

Серйозність: Висока. Оголошена ціль недійсна або не підтримується; виправте анотацію.

Чому це важливо

Google підтримує в hreflang дволітерні коди мов ISO та необов’язкові коди системи письма й регіону. Некоректне чи непідтримуване значення мови не може позначити альтернативну мову, яку ви мали на увазі.

Що зробити

  1. Знайдіть зафіксовану анотацію в HTML, HTTP-заголовку Link чи названому файлі карти сайту.
  2. Замініть назви, як-от english, кодом мови, як-от en. Використовуйте дефіси, як у en-US, і ставте необов’язкову зареєстровану систему письма перед регіоном.
  3. Використовуйте x-default лише для резервної версії. Сама абревіатура країни не замінює мови.

Що ми читаємо

Ми читаємо наявні декларації в HTML, HTTP-заголовку Link і карті сайту для сторінки. Кожна анотація зберігає свій початковий канал джерела й файл карти сайту.

Ми звіряємо захоплене значення з керованим реєстром мов і систем письма, використовуючи вужчий формат hreflang. Регістр літер ігнорується. Недійсне форматування, непідтримувані коди мов і незареєстровані системи письма належать до цієї перевірки; для недійсних кодів регіонів є окрема знахідка.

Усі три канали декларацій повинні мати повне охоплення перевірки. Відсутні дані джерела, прострочений знімок довідника чи ліміт ресурсів дають результат «не перевірено», а не чистий результат. Якщо анотацій немає, перевірка не застосовується.

Приклад і докази

Ілюстративний приклад виправленої мовної анотації.

<link rel="alternate" hreflang="en_US" href="https://bakery.example/en/">
<link rel="alternate" hreflang="en-US" href="https://bakery.example/en/">

Підтвердити й перевірити знову

Перевірте самі: Огляньте сире джерело, назване в знахідці, і перевірте кожне значення hreflang.

Повторна перевірка: Повний аудит — Запустіть ще один повний аудит сайту. Проблема закривається, лише коли ту саму сторінку перевірено з достатнім охопленням декларацій і довідкових даних і проблеми немає. Сторінка, яку не вдалося прочитати, чи відсутнє охоплення не доводять виправлення.

Обмеження та джерела

Чинний код однаково може описувати не той контент. Наприклад, be означає білоруську; ця перевірка не робить висновку, що хтось мав на увазі Бельгію.

Атрибут lang в HTML дотримується ширшого стандарту мовних тегів і перевіряється окремо. Це правило не виконує JavaScript і не запитує альтернативну URL-адресу.

Упевненість: Висока У знахідці показано захоплену анотацію й невдалий пошук коду.

Джерела

Редакційна перевірка: 2 листопада 2026