{"canonical_url":"https://engineer.company/uk/glossary/hreflang/","content_markdown":"# hreflang\n\n## Що це таке\n\nАтрибут `hreflang` на посиланні повідомляє, якою мовою написано сторінку на\nіншому його кінці. HTML дозволяє ставити його на елементи `a`, `area` і `link`,\nале відомим його зробило одне застосування: набір елементів\n`link rel=\"alternate\"` у `head` сторінки, по одному на кожну мовну версію, яким\nсайт повідомляє пошуковим системам, що кілька адрес містять той самий вміст\nрізними мовами.\n\n```html\n\u003clink rel=\"alternate\" hreflang=\"en\" href=\"https://example.com/guide/\" /\u003e\n\u003clink rel=\"alternate\" hreflang=\"da\" href=\"https://example.com/da/guide/\" /\u003e\n\u003clink rel=\"alternate\" hreflang=\"x-default\" href=\"https://example.com/guide/\" /\u003e\n```\n\nСтандарт HTML називає цей атрибут «суто рекомендаційним». Його значення мусить\nбути коректним мовним тегом за BCP 47, а браузер має визначати мову завантаженої\nсторінки з самої сторінки, а не з посилання, яке до неї привело. У поєднанні з\n`rel=\"alternate\"` атрибут `hreflang`, що відрізняється від мови самого\nдокумента, позначає ціль як переклад.\n\nПошукові системи перетворили цю рекомендаційну примітку на протокол. Google\nописує три рівноцінні способи передати набір: елементи `link` у `head`,\nзаголовок HTTP `Link` для PDF та інших файлів без `head` і записи в XML-карті\nсайту. Кожна версія перелічує саму себе й усі інші версії, з повними абсолютними\nадресами. Пара враховується лише тоді, коли обидві сторінки називають одна одну,\nтож чужий сайт не може оголосити себе перекладом ваших сторінок. Коди\nскладаються з мови за ISO 639-1 і, за потреби, регіону за ISO 3166-1, а сам\nрегіон без мови недійсний. Зарезервоване значення `x-default` вказує сторінку\nдля читачів, чия мова не збігається з жодною з інших, і, як зазначає Google,\nзадумане воно для сторінок вибору мови.\n\nІз ним легко сплутати двох сусідів. Атрибут `lang` каже, якою мовою текст перед\nчитачем; `hreflang` каже, якою мовою сторінка, на яку веде посилання. Google\nзазначає, що не використовує жодного з них, щоб визначити мову сторінки, тож\n`hreflang` не зробить сторінку данською; він повідомляє пошуковій системі, що\nданська сторінка, яку та вже розпізнала, належить до однієї групи з англійською.\nА канонічна URL зливає дублікати в одну проіндексовану адресу, тоді як\n`hreflang` позначає мовні альтернативи й допомагає пошуковій системі обрати,\nяку версію показати.\n\n## Чому це важливо\n\n`hreflang` фіксує одне рішення: чи утворюють мовні версії сторінки одну групу,\nчи їх оцінюють як окремі сторінки. Окремо кожна версія змагається сама за себе,\nі пошукова система може показати данському читачеві англійську сторінку або\nвивести обидві версії в тих самих результатах. Оголошені групою, версії\nсприймаються як один вміст, і пошукова система може запропонувати ту, що\nвідповідає мовним налаштуванням читача.\n\nГрупа має сенс лише тоді, коли версії справді містять той самий вміст. Сайтові\nоднією мовою `hreflang` не потрібен узагалі, а два мовні розділи, що різняться\nпо суті, теж не група. Регіональні варіанти з невеликими відмінностями, як-от\nсторінки `en-GB` і `en-US` з різними цінами, утворюють групу так само.\n\nЦіна — облік, і він зростає з квадратом кількості мов. Кожна версія кожної\nсторінки несе повний список, тож коли один переклад додають, переносять чи\nзнімають, змінюється `head` усіх сторінок-сестер, а список, правильний на\nбільшості сторінок і хибний на кількох, ламається тихо: пари, що ведуть в обидва\nбоки, використовуються, решта відкидається, і жодної видимої помилки немає. Тому\n`hreflang` погано пасує ручному редагуванню й природно — генераторові, який\nвиводить набір кожної сторінки з одного списку. Від `hreflang` залежить, яку з\nкількох версій побачить користувач пошуку.\n\n## Як це виглядає на практиці\n\nЦей сайт\n[збирає свої мовні версії з одного дерева вмісту](/uk/portfolio/built-a-multilingual-hugo-site-in-3-languages/),\nтож кожна сторінка має набір відповідних перекладів, які треба оголосити.\n\nОдин шаблон вирішує, які переклади оголошувати, і його рішення використовують у кількох\nмісцях: у наборі `hreflang` у `head`, у тегах `og:locale:alternate`, якими\nкористуються попередні перегляди посилань, у списку альтернатив у карті сайту,\nу `inLanguage` у структурованих даних сайту і, після ще одного віднімання, у мовній\nсмузі, яку бачить читач. Список містить і саму сторінку, а отже дає те посилання\nна себе, якого вимагають правила. Коди називають лише мови, як-от `en`, `da` і `uk`,\nтож кожну версію пропонують усім читачам цієї мови, де б вони не були, а\nанглійський запис пишеться вдруге як `x-default`. І `head`, і карта сайту несуть\nнабір, згенерований з того самого списку, тож розійтися вони не можуть.\n\nПоділ між машинами й читачами навмисний. На попередньому етапі реалізації\n[українську версію оголошували пошуковим роботам і вносили до карт сайту](/uk/credits/),\nале мовний перемикач у верхній панелі її не пропонував. Цю відмінність\nконтролював один прапорець конфігурації: пошукові роботи отримували взаємні\nпосилання на українську версію, а змінювався лише мовний перемикач для читача.\nДругий прапорець, для мови, яку вже збирають, але яка ще не готова, прибирає її\nз обох списків і позначає її сторінки `noindex`. Сторінка такою мовою теж не\nоголошує сестер, бо `hreflang` від неоголошеної сторінки до оголошеної — це\nпара, яку пошукова система бачить лише з одного кінця.\n\nКопії підкоряються тій самій логіці. Сторінка на одному з тематичних субдоменів,\nчия канонічна URL вказує на основний сайт, узагалі не виводить `hreflang`: набір\nчитають на тій сторінці, яку пошукова система прийняла як канонічну, а копія, що\nназивала б переклади свого хоста, суперечила б власній канонічній URL. Перемикач\nмов на ній усе одно працює, бо читач, якому потрібна данська, однаково має її\nотримати.\n\nПеревірка зібраних сторінок вимагає, щоб кожна сторінка з альтернативами містила\n`x-default` і власну мову, а кожна альтернатива була зібраною сторінкою\nоголошеною мовою й вела назад. Правило про посилання на себе потрібне не для\nгалочки. Генератор має два списки з майже однаковими назвами: `.Translations`,\nщо не містить поточної сторінки, і `.AllTranslations`, що містить, і помилка в\nодне слово прибирає власну мову кожної сторінки і з `head`, і з мовної смуги\nводночас, тож вони й далі узгоджені між собою. На навмисно зламаній збірці ця\nодна вимога виявилася єдиною в перевірці, що зловила 528 із 792 сторінок.\n\n## Де виникають проблеми\n\n**Користувачам пошуку показують версію не тією мовою.** Данського читача ведуть\nна англійську сторінку, або обидві версії стоять поруч. Пари ведуть в один бік:\nданська сторінка називає англійську, але англійська досі перелічує лише ті мови,\nщо були раніше, а пошукові системи ігнорують пару без зворотного посилання.\nБудуйте набір кожної сторінки з одного списку, що містить і саму сторінку, і\nперевіряйте взаємність на зібраних сторінках.\n\n**Анотації цілої мови нічого не дають.** Розмітка на місці й є коректним HTML,\nале версії трактують як не пов'язані між собою. Коди означають щось інше, ніж\nзадумано: `ua` чи `dk` там, де мови мають коди `uk` і `da`, `be` в значенні\nБельгії, хоча це код білоруської мови, або `en-UK` замість `en-GB`, бо `UK` —\nзарезервований код регіону, який Google ігнорує. Беріть мову з ISO 639-1,\nдодавайте регіон з ISO 3166-1 лише там, де вміст справді різниться між країнами,\nі пам'ятайте, що коректний тег BCP 47 Google може й не підтримувати.\n\n**Переклади випадають з індексу.** У пошуку з'являється лише мова оригіналу, а\nпереклади трактують як його дублікати. Кожен переклад називає своєю канонічною\nURL оригінал, а це просить злити переклад з оригіналом, тоді як його `hreflang`\nпросить його показувати. Робіть кожну мовну версію власною канонічною URL;\nGoogle радить, щоб канонічна сторінка була тією самою мовою.\n\n**Сторінку, що просила лишитися поза пошуком, однаково оголошують.** Чорнеткова\nмова з позначкою `noindex` з'являється серед альтернатив опублікованих сторінок\nабо сама перелічує їх у своєму `head`. Оголошення й директиву задано в різних\nмісцях, тож сайт дає пошуковому роботові дві відповіді про ту саму адресу.\nВирішуйте для кожної мови окремо, оголошена вона в обидва боки чи в жоден,\nтримайте це рішення в одному параметрі, який читають усі списки, і звіряйте з\nним зібрані сторінки.\n\n## Що почитати далі\n\n- [HTML Standard: the hreflang attribute](https://html.spec.whatwg.org/multipage/links.html#attr-hyperlink-hreflang)\n  — що атрибут означає на посиланні і чому браузер не має йому довіряти.\n- [HTML Standard: link type \"alternate\"](https://html.spec.whatwg.org/multipage/links.html#rel-alternate)\n  — як `hreflang` і `type` описують переклад або інший формат того самого\n  документа.\n- [RFC 5646: Tags for Identifying Languages](https://www.rfc-editor.org/rfc/rfc5646)\n  — синтаксис BCP 47, якому має відповідати значення атрибута.\n- [Google Search Central: localized versions of your pages](https://developers.google.com/search/docs/specialty/international/localized-versions)\n  — три способи передати набір, правило взаємності та `x-default`.\n\n\u003chttps://engineer.company/uk/glossary/hreflang/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як hreflang об'єднує мовні версії сторінки, чому кожен набір має називати сам себе й вести в обидва боки, і через які помилки його ігнорують.","formats":{"gemtext":"https://engineer.company/uk/glossary/hreflang/index.gmi","gopher":"https://engineer.company/uk/glossary/hreflang/gophermap","html":"https://engineer.company/uk/glossary/hreflang/","json":"https://engineer.company/uk/glossary/hreflang/index.json","markdown":"https://engineer.company/uk/glossary/hreflang/index.md","pdf":"https://engineer.company/uk/glossary/hreflang/index.pdf"},"kind":"page","language":"uk","title":"Що таке hreflang?","url":"https://engineer.company/uk/glossary/hreflang/","version":1}