Коды языка хрефланг: полный список и правила

Полный справочник допустимых кодов языка и региона hreflang с правилами форматирования Google, x-default, кодами скриптов и ошибками кода, которые нарушают работу hreflang.
Нет данных карты Никаких обязательств

· Обновлено · Алекс Б · Блог

Подведите итог этому посту следующим образом: 22 мин чтения

Значение hreflang состоит из двух букв Код языка ISO 639-1 (например fr), за которым может следовать дефис и две буквы Код региона ISO 3166-1 альфа-2 (например fr-CA для франкоговорящих в Канаде). Язык всегда на первом месте, регион никогда не может использоваться сам по себе, а зарезервированное значение x-default отмечает резервную страницу. Google не поддерживает другие системы кодов, поэтому коды зон UN M.49, такие как es-419 для латиноамериканского испанского языка игнорируются.

Ключевые выводы

  • Формат: language или language-REGION, например de, de-AT, pt-BR. Для Google регистр не имеет значения, но строчные буквы и заглавные буквы являются общепринятыми.
  • Используйте ISO 639-1 для языка и ISO 3166-1 альфа-2 для региона. Больше ничего не поддерживается, в том числе es-419, en-UK и en-EU.
  • Подтег скрипта из ISO 15924 разрешен, когда он вам нужен: zh-Hans, zh-Hant, sr-Latn.
  • Каждая страница в наборе должна содержать список себя и всех своих альтернатив, и каждая альтернатива должна содержать обратную ссылку.
  • Добавлять x-default для страницы, которую вы хотите, чтобы люди видели, когда ни один из перечисленных языков или регионов не совпадает.

Полные списки действительных языковых кодов и кодов регионов приведены ниже на этой странице. Правила взяты из собственной документации Google, Расскажите Google о локализованных версиях вашей страницы, который Google последний раз обновлял 21 сентября 2026 года.

Как строится код hreflang

Значение hreflang состоит из трех частей, разделенных дефисами:

ЧастьСтандартОбязательно?Примеры
ЯзыкISO 639-1 (две буквы)Да, всегда первымen, es, ja, ar
СценарийISO 15924 (четыре буквы)НеобязательноHans, Hant, Latn, Cyrl
ОбластьISO 3166-1 альфа-2 (две буквы)НеобязательноUS, GB, MX, BR

Итак, все это справедливо: en, en-GB, zh-Hant, zh-Hant-TW, sr-Latn. Первая часть должна быть языком. Как говорится в документации Google, код страны сам по себе указать нельзя. Его примером является Бельгия: nl-BE (голландский для пользователей в Бельгии) и de-BE (немецкий для пользователей в Бельгии) верны, в то время как be само по себе означает белорусский, а не бельгийский.

Google также утверждает, что значение не зависит от регистра. en-gb, EN-GB и en-GB все работы. Большинство команд пишут язык строчными буквами, а регион - прописными, потому что именно так их печатают списки ISO, и это облегчает обнаружение ошибок при проверке кода.

Только язык или язык плюс регион?

Используйте а только язык код (es) когда одна страница обслуживает каждого носителя этого языка, где бы он ни жил. Большинство сайтов, переведенных с помощью инструмента перевода веб-сайтов, попадают в эту группу: одна испанская версия, одна немецкая версия и так далее.

Добавить а область (es-MX, es-ES) только тогда, когда у вас действительно разные страницы для разных стран. Вескими причинами являются разные цены или валюты, разная доставка и юридический текст или намеренно разные формулировки (например pt-BR и pt-PT, или en-US и en-GB с местной орфографией и ценами).

Вы можете смешать оба варианта. Распространенным шаблоном является общая страница плюс региональные исключения:

<link rel="alternate" hreflang="es" href="https://example.com/es/" />
<link rel="alternate" hreflang="es-MX" href="https://example.com/es-mx/" />
<link rel="alternate" hreflang="en" href="https://example.com/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />

Поисковик в Мексике получает es-MX страница; испаноговорящий в Чили, Испании или США получает общее es страница.

А как насчет латиноамериканского испанского языка (es-419)?

Это самый распространенный вопрос о кодах hreflang, и ответ на него короткий: Google не поддерживает es-419. В документации он указан как пример неподдерживаемого кода, поскольку 419 — это код зоны ООН M.49 (“Латинская Америка и Карибский бассейн”), а не код страны ISO 3166-1. То же самое относится и к другим номерам M.49, таким как 150 (Европа).

Если у вас есть одна страница на латиноамериканском испанском языке, у вас есть два рабочих варианта:

  1. Отметьте это как простое es. Если у вас нет отдельной версии на испанском языке, это самый простой выбор, охватывающий всех носителей испанского языка.
  2. Перечислите страны по отдельности. Если у вас также есть страница Испании (es-ES), укажите несколько кодов стран на одном и том же URL-адресе Латинской Америки: es-MX, es-AR, es-CO, es-CL, es-PE и так далее. Один URL-адрес может содержать несколько значений hreflang.

То же самое относится и к французскому языку для Африки, арабскому языку для Персидского залива или “английскому языку для Европы”: поддерживаемых региональных групп нет, поэтому используйте только язык или перечислите страны.

x-default: резервное значение

x-default это не язык. Это зарезервированное значение, которое использует Google “когда ни один другой язык/регион не соответствует настройкам браузера пользователя”. Укажите его на странице выбора языка или на вашей основной версии:

<link rel="alternate" hreflang="x-default" href="https://example.com/" />

Это необязательно, но стоит добавить. Без него посетитель, язык которого вы не охватываете, получает ту версию, которую выберет Google.

Куда идет код: три способа реализации hreflang

Google принимает hreflang в трех местах. Выбирайте один метод на странице; вам не нужны все три.

1. HTML <link> теги в <head>

<link rel="alternate" hreflang="en" href="https://example.com/pricing" />
<link rel="alternate" hreflang="de" href="https://example.com/de/pricing" />
<link rel="alternate" hreflang="fr-CA" href="https://example.com/fr-ca/pricing" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing" />

2. HTTP Link заголовки (полезно для PDF-файлов и других файлов, отличных от HTML)

Link: <https://example.com/guide.pdf>; rel="alternate"; hreflang="en",
      <https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"

3. Записи карты сайта XML

<url>
  <loc>https://example.com/pricing</loc>
  <xhtml:link rel="alternate" hreflang="en" href="https://example.com/pricing" />
  <xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/pricing" />
</url>

Какой бы вариант вы ни выбрали, применяются три правила из документации Google:

  • Каждая версия перечисляет себя и каждую другую версию. Набор на немецкой странице такой же, как набор на английской странице.
  • Ссылки должны быть взаимными. Если страница X указывает на страницу Y, страница Y должна указывать обратно на X, иначе аннотацию можно проигнорировать.
  • URL-адреса должны быть полностью квалифицированы, в том числе https://. /de/pricing или //example.com/de/pricing не принимаются.

Полное описание самой реализации, включая канонические материалы и тестирование, см. на нашем сайте полное руководство по hreflang и объяснитель на самоссылающиеся теги hreflang.

Наиболее распространенные ошибки кода hreflang

Большинство сломанных наборов hreflang, которые мы видим, сводятся к нескольким неправильным кодам. Некоторые из них являются допустимыми кодами, которые просто означают что-то другое, поэтому валидаторы не всегда их отмечают.

НаписаноЧто это на самом деле означаетИспользуйте вместо
en-UKНичего: UK не является кодом ISO 3166-1en-GB
es-LAИспанский для Лаос (LA это Лаос)es, или отдельные страны
es-419Не поддерживается (код города ООН M.49)es, или отдельные страны
en-EUНичего: EU не является кодом страныen, или отдельные страны
jpНичего: не языковой кодja (японский)
cnНичего: не языковой кодzh (китайский), zh-CN для Китая
krКанури, язык, на котором говорят вокруг озера Чадko (корейский)
seСеверные саамыsv (шведский)
dk, cz, gr, uaНе языковые кодыda, cs, el, uk
uk значение “британский английский”Украинскиеen-GB
be означает БельгияБелорусскийnl-BE, fr-BE, de-BE
in, iwСтарые, отозванные кодыid (индонезийский), he (иврит)
filТрехбуквенный код, отсутствует в ISO 639-1tl это код ISO 639-1 для тагальского языка

Закономерность, лежащая в основе большинства из них: люди печатают страна код, где язык код принадлежит. Япония - это JP но японский язык ja; Швеция - это SE но шведский язык sv; Дания - это DK но датский язык da.

Другие частые проблемы вообще не связаны с кодами: отсутствующие обратные ссылки, относительные URL-адреса, hreflang, указывающий на URL-адрес, который перенаправляет или блокируется, и канонический тег, который указывает каждую языковую версию на английскую страницу. Наша статья о ошибка отсутствия возвращаемых тегов рассказывает, как это исправить.

Китайский, сербский и другие языки с более чем одной письменностью

Некоторые языки пишутся более чем одним шрифтом, и шрифт имеет большее значение, чем страна.

  • Китайский. Использовать zh-Hans для упрощенного и zh-Hant для традиционного, если ваши страницы отличаются по сценарию, а не по стране. Если они специфичны для конкретной страны, zh-CN, zh-TW и zh-HK тоже работают; Google отмечает, что с zh-TW письменность (традиционная) происходит из региона. Вы можете быть откровенны с zh-Hant-TW.
  • Сербский. sr-Latn и sr-Cyrl разделите латинскую и кириллическую версии.
  • Норвежский. ISO 639-1 имеет no (норвежский), nb (Бокмол) и nn (нюнорск). Большинство норвежских веб-сайтов находятся в букмоле; используйте тот код, который соответствует тексту, и оставайтесь последовательными.

Общие языковые и региональные комбинации

Именно такие комбинации нужны большинству многоязычных сайтов. Все они действительны в соответствии с правилами Google.

Аудиторияхрефланг
Английский, любая странаen
Английский, США / Великобритания/Канада / Австралияen-US / en-GB / en-CA / en-AU
Испанский, любая странаes
Испанский, Испания / Мексика / Аргентинаes-ES / es-MX / es-AR
Португальский, Бразилия / Португалияpt-BR / pt-PT
Французский, Франция / Канада / Бельгия / Швейцарияfr-FR / fr-CA / fr-BE / fr-CH
Немецкий, Германия / Австрия / Швейцарияde-DE / de-AT / de-CH
Китайский, упрощенный / традиционныйzh-Hans / zh-Hant
Китайский, Китай / Тайвань / Гонконгzh-CN / zh-TW / zh-HK
Японский / Корейскийja / ko
Арабский, любая страна / Саудовская Аравия / ОАЭar / ar-SA / ar-AE
Хинди / Индонезийский / Вьетнамский / Тайскийhi / id / vi / th
Украинский / Польский / Турецкий / Голландскийuk / pl / tr / nl
Резервный вариант для всех остальныхx-default

Как ConveyThis устанавливает для вас коды hreflang

Если вы переводите свой сайт с помощью ConveyThis, вы не пишете эти теги вручную. При использовании структуры URL-адресов поддомена или подпапки ConveyThis добавляет теги hreflang для каждого публикуемого вами языка, используя правильные языковые коды, вместе с переведенными заголовками страниц и метаописаниями. Это устраняет две ошибки, лежащие в основе большинства сломанных наборов: неправильные коды и отсутствие обратных ссылок. Вы можете прочитать, что еще он обрабатывает на многоязычная страница SEO, и Руководство по структуре URL-адресов объясняет, какую структуру выбрать и какие планы ее включают. Поддомены и подпапки доступны в бизнес-плане; см ценообразование для получения подробной информации.

Если вы создаете hreflang самостоятельно, то приведенные ниже списки ссылок — это единственные коды, которые вам понадобятся.

Полный список кодов языка хрефланг (ISO 639-1)

Все 183 двухбуквенных кода в ISO 639-1, опубликованные Библиотека Конгресса, орган регистрации ISO 639-2. Любой из них может быть первой частью значения hreflang. Если код имеет несколько имен, они разделены косой чертой.

Языккод hreflang
Абхазскийab
Издалекаaa
Африкаансaf
Аканak
Албанскийsq
Амхарскийam
Арабскийar
Арагонскийan
Армянскийhy
Ассамскийas
Аварскийav
Авестийскийae
Аймараay
Азербайджанскийaz
Бамбараbm
Башкирскийba
Баскскийeu
Белорусскийbe
Бенгальскийbn
Бисламаbi
Боснийскийbs
Бретонскийbr
Болгарскийbg
Бирманскийmy
Каталанский / Валенсийскийca
Центральный кхмерскийkm
Чаморроch
Чеченскийce
Чичева / Чева / Ньянджаny
Китайскийzh
Церковнославянский / Старославянский / Церковнославянский / Староболгарский / Старославянскийcu
Чувашскийcv
Корнуоллkw
Корсиканскийco
Криcr
Хорватскийhr
Чешскаяcs
Датскийda
Дивехи / Дивехи / Мальдивскийdv
Голландский / Фламандскийnl
Дзонгкхаdz
Английскийen
Эсперантоeo
Эстонскийet
Овцаee
Фарерскийfo
Фиджийскийfj
Финскийfi
Французскийfr
Фулаff
Гэльский / Шотландский гэльскийgd
Галисийскийgl
Гандаlg
Грузинскийka
Немецкийde
Греческий (современный)el
Гуараниgn
Гуджаратиgu
Гаитянский / Гаитянский креольскийht
Хаусаha
Ивритhe
Герероhz
Хиндиhi
Хири Мотуho
Венгерскийhu
Исландскийis
Я делаюio
Игбоig
Индонезийскийid
Интерлингва (Международная ассоциация вспомогательных языков)ia
Интерлингва / Западныйie
Инуктитутiu
Инупиакik
Ирландскийga
Итальянскийit
Японскийja
Яванскийjv
Калааллисут / гренландскийkl
Каннадаkn
Кануриkr
Кашмирскийks
Казахскийkk
Кикую / Гикуюki
Киньяруандаrw
Киргизский / Киргизскийky
Комиkv
Конгоkg
Корейскаяko
Куаньяма / Кваньямаkj
Курдскийku
Лаоlo
Латинскийla
Латышскийlv
Лимбурган / Лимбургер / Лимбургскийli
Лингалаln
Литовскийlt
Люба-Катангаlu
Люксембургский / Летцебургскийlb
Македонскийmk
Малагасийскийmg
Малайскийms
Малаяламml
Мальтийскийmt
Мэнскийgv
Маориmi
Маратхиmr
Маршалловы островаmh
Монгольскийmn
Науруna
Навахо / Навахоnv
Ндонгаng
Непальскийne
Северный Ндебелеnd
Северные саамыse
Норвежский букмолnb
Норвежский нюнорскnn
Норвежскийno
Окситанскийoc
Оджибваoj
Орияor
Оромоom
Осетинский / Осетинскийos
Палиpi
Пенджаби / Пенджабиpa
Персидскийfa
Польскаяpl
Португальскийpt
Пушту / Пуштуps
Кечуаqu
Румынский / Молдавский / Молдавскийro
Ретороманскийrm
Рундиrn
Русскийru
Самоанскийsm
Сангоsg
Санскритsa
Сардинскийsc
Сербскаяsr
Шонаsn
Сычуань И / Нуосуii
Синдхиsd
Сингальский / сингальскийsi
Словацкийsk
Словенскийsl
Сомалийскийso
Сото, Южныйst
Южный Ндебелеnr
Испанский / кастильскийes
Суданцыsu
Суахилиsw
Сватиss
Шведскийsv
Тагальскийtl
Таитянскийty
Таджикскийtg
Тамильскийta
Татарскийtt
Телугуte
Тайскийth
Тибетскийbo
Тигриньяti
Тонга (острова Тонга)to
Тсонгаts
Тсванаtn
Турецкийtr
Туркменскийtk
Твиtw
Уйгурский / уйгурскийug
Украинскиеuk
Урдуur
Узбекскийuz
Вендаve
Вьетнамскийvi
Волапюкvo
Валлонскийwa
Валлийскийcy
Западно-фризскийfy
Волофwo
Косаxh
Идишyi
Йорубаyo
Чжуан / Чуанza
Зулуzu

Полный список кодов регионов хрефланга (ISO 3166-1 альфа-2)

Всем 249 официально присвоены коды ISO 3166-1 альфа-2. Любой из них может следовать языковому коду, например. en-IE или ar-EG. Коды, которых нет в этом списке, например UK, EU или XK, или числовые коды ООН M.49, такие как 419, не поддерживаются Google.

Страна или территорияКод региона
АфганистанAF
АлбанияAL
АлжирDZ
Американское СамоаAS
АндорраAD
АнголаAO
АнгильяAI
АнтарктидаAQ
Антигуа и БарбудаAG
АргентинаAR
АрменияAM
АрубаAW
АвстралияAU
АвстрияAT
АзербайджанAZ
БагамыBS
БахрейнBH
БангладешBD
БарбадосBB
БеларусьBY
БельгияBE
БелизBZ
БенинBJ
Бермудские островаBM
БутанBT
БоливияBO
Бонайре, Синт-Эстатиус и СабаBQ
Босния и ГерцеговинаBA
БотсванаBW
Остров БувеBV
БразилияBR
Британская территория в Индийском океанеIO
Британские Виргинские островаVG
Бруней-ДаруссаламBN
БолгарияBG
Буркина-ФасоBF
БурундиBI
Кабо-ВердеCV
КамбоджаKH
КамерунCM
КанадаCA
Каймановы островаKY
Центральноафриканская РеспубликаCF
ЧадTD
ЧилиCL
КитайCN
Остров РождестваCX
Кокосовые (Килинг) островаCC
КолумбияCO
Коморские островаKM
КонгоCG
Конго (Демократическая Республика)CD
Острова КукаCK
Коста-РикаCR
ХорватияHR
КубаCU
КюрасаоCW
КипрCY
Чешская РеспубликаCZ
Кот-д'ИвуарCI
ДанияDK
ДжибутиDJ
ДоминикаDM
Доминиканская РеспубликаDO
ЭквадорEC
ЕгипетEG
СальвадорSV
Экваториальная ГвинеяGQ
ЭритреяER
ЭстонияEE
ЭсватиниSZ
ЭфиопияET
Фолклендские островаFK
Фарерские островаFO
ФиджиFJ
ФинляндияFI
ФранцияFR
Французская ГвианаGF
Французская ПолинезияPF
Французские Южные ТерриторииTF
ГабонGA
ГамбияGM
ГрузияGE
ГерманияDE
ГанаGH
ГибралтарGI
ГрецияGR
ГренландияGL
ГренадаGD
ГваделупаGP
ГуамGU
ГватемалаGT
ГернсиGG
ГвинеяGN
Гвинея-БисауGW
ГайанаGY
ГаитиHT
Остров Херд и острова МакдональдHM
Святой ПрестолVA
ГондурасHN
ГонконгHK
ВенгрияHU
ИсландияIS
ИндияIN
ИндонезияID
ИранIR
ИракIQ
ИрландияIE
Остров МэнIM
ИзраильIL
ИталияIT
ЯмайкаJM
ЯпонияJP
ДжерсиJE
ИорданияJO
КазахстанKZ
КенияKE
КирибатиKI
КувейтKW
КыргызстанKG
ЛаосLA
ЛатвияLV
ЛиванLB
ЛесотоLS
ЛиберияLR
ЛивияLY
ЛихтенштейнLI
ЛитваLT
ЛюксембургLU
МакаоMO
МадагаскарMG
МалавиMW
МалайзияMY
МальдивыMV
МалиML
МальтаMT
Маршалловы ОстроваMH
МартиникаMQ
МавританияMR
МаврикийMU
МайоттаYT
МексикаMX
МикронезияFM
МолдоваMD
МонакоMC
МонголияMN
ЧерногорияME
МонтсерратMS
МароккоMA
МозамбикMZ
МьянмаMM
НамибияNA
НауруNR
НепалNP
НидерландыNL
Новая КаледонияNC
Новая ЗеландияNZ
НикарагуаNI
НигерNE
НигерияNG
НиуэNU
Остров НорфолкNF
Северная КореяKP
Северная МакедонияMK
Северные Марианские островаMP
НорвегияNO
ОманOM
ПакистанPK
ПалауPW
ПалестинаPS
ПанамаPA
Папуа-Новая ГвинеяPG
ПарагвайPY
ПеруPE
ФилиппиныPH
ПиткэрнPN
ПольшаPL
ПортугалияPT
Пуэрто-РикоPR
КатарQA
РумынияRO
РоссияRU
РуандаRW
РеюньонRE
Сен-БартелемиBL
Остров Святой Елены, Вознесения и Тристан-да-КуньяSH
Сент-Китс и НевисKN
Сент-ЛюсияLC
Сен-Мартен (французская часть)MF
Сен-Пьер и МикелонPM
Сент-Винсент и ГренадиныVC
СамоаWS
Сан-МариноSM
Сан-Томе и ПринсипиST
Саудовская АравияSA
СенегалSN
СербияRS
Сейшельские островаSC
Сьерра-ЛеонеSL
СингапурSG
Сен-Мартен (голландская часть)SX
СловакияSK
СловенияSI
Соломоновы ОстроваSB
СомалиSO
Южная АфрикаZA
Южная Георгия и Южные Сандвичевы островаGS
Южная КореяKR
Южный СуданSS
ИспанияES
Шри-ЛанкаLK
СуданSD
СуринамSR
Шпицберген и Ян-МайенSJ
ШвецияSE
ШвейцарияCH
СирияSY
ТайваньTW
ТаджикистанTJ
ТанзанияTZ
ТаиландTH
Тимор-ЛештиTL
ТогоTG
ТокелауTK
ТонгаTO
Тринидад и ТобагоTT
ТунисTN
ТуркменистанTM
Острова Тёркс и КайкосTC
ТувалуTV
ТурцияTR
США Виргинские островаVI
УгандаUG
УкраинаUA
Объединённые Арабские ЭмиратыAE
Соединенное КоролевствоGB
Соединенные ШтатыUS
Малые отдаленные острова СШАUM
УругвайUY
УзбекистанUZ
ВануатуVU
ВенесуэлаVE
ВьетнамVN
Уоллис и ФутунаWF
Западная Сахара*EH
ЙеменYE
ЗамбияZM
ЗимбабвеZW
Аландские островаAX

Часто задаваемые вопросы

Чувствителен ли hreflang к регистру? Нет. Google принимает en-gb, EN-GB и en-GB. Обычно используется строчная буква и заглавная буква.

Должен ли я использовать подчеркивание, как в en_US? Нет. Значения hreflang используют дефис: en-US. Форма подчеркивания взята из настроек локали программного обеспечения, а не из hreflang.

Могу ли я использовать трехбуквенные языковые коды? Документация Google поддерживает только языковые коды ISO 639-1, которые состоят всего из двух букв. Язык, имеющий только трехбуквенный код (ISO 639-2 или 639-3), не входит в список поддерживаемых.

Использует ли Google HTML lang атрибут вместо этого? Нет. Google определяет язык страницы по ее видимому содержимому и не использует сигналы уровня кода, такие как lang атрибуты, согласно его руководство по многорегиональным и многоязычным сайтам. Держать lang для доступности и браузеров, а также используйте hreflang для подключения версий.

Нужен ли мне код региона для каждой страницы? Нет. Большинству переведенных сайтов нужны только языковые коды. Добавляйте регионы, если страницы действительно различаются по странам.

Хотите, чтобы каждая страница автоматически подключалась с правильными кодами hreflang? Создать учетную запись ConveyThis и добавьте свой родной язык.

Поделиться:
G2 High Performer Spring 2023
G2 Easiest Setup Fall 2024
G2 Best Support Spring 2025