Document doesn't have a valid hreflang — Google Lighthouse SEO
2분 읽기
문서에 유효한 hreflang이 없습니다
hreflang은 검색엔진에 대체 페이지 버전을 알려주어, 사용자가 선호하는 언어나 지역의 콘텐츠에 접근할 수 있도록 돕습니다.
해당 항목에서 통과하지 못한 이유
Lighthouse는 페이지의 <head>와 응답 헤더를 검사하여 유효하지 않은 hreflang 링크를 식별합니다. 언어 코드는 검증하지만 사이트맵이나 지역 코드는 검증하지 않습니다.
3가지 구현 방법
방법 1 — HTML Head 태그
<link rel="alternate" hreflang="en" href="https://example.com" />
<link rel="alternate" hreflang="es" href="https://es.example.com" />각 언어 버전은 모든 변형을 포함해야 합니다. 사용자가 언어 환경설정을 선택하는 경우 hreflang="x-default"를 사용합니다.
방법 2 — HTTP 응답 헤더
Link 헤더를 통해 응답 메타데이터에서 대체 버전을 지정할 수 있습니다.
방법 3 — 사이트맵
XML 사이트맵에 xhtml:link 요소와 hreflang 속성을 포함할 수 있습니다.
가이드라인
- 언어 코드는 ISO 639-1 형식을 따라야 합니다
- 지역 코드(선택)는 ISO 3166-1 alpha-2를 사용합니다 (예: "es-mx" — 멕시코 스페인어)
출처: