hreflang 태그 생성기
다국어 페이지용 hreflang link 태그를 생성합니다.
여러 언어·지역으로 같은 콘텐츠를 제공한다면, 검색엔진에 “이 페이지의 다른 언어 버전은 여기”라고 알려주는 hreflang 태그가 필요합니다. 이 생성기는 언어 코드와 해당 URL을 행으로 입력하면, 페이지 <head>에 그대로 붙여넣을 수 있는 <link rel="alternate"> 묶음을 만들어 줍니다.
모든 입력은 브라우저 안에서만 처리되며 어떤 서버로도 전송되지 않습니다. x-default 행을 더해 언어가 매칭되지 않는 방문자에게 보여줄 기본 페이지도 지정할 수 있고, 같은 코드를 두 번 넣으면 경고로 알려 줍니다.
hreflang은 무엇이고 언제 쓰나
hreflang은 같은 콘텐츠의 언어·지역별 대체 버전을 검색엔진에 안내하는 속성입니다. 한국어 사용자에게는 한국어 페이지를, 미국 영어 사용자에게는 en-US 페이지를 노출하도록 도와 중복 콘텐츠 문제를 줄이고 현지화된 결과를 제공합니다. 값은 ISO 639-1 언어 코드 단독(ko, en, ja) 또는 언어-지역 형식(en-US, pt-BR, zh-Hant)을 씁니다.
상호 참조(reciprocal)는 필수
hreflang의 가장 중요한 규칙은 상호 참조입니다. A 페이지가 B를 대체 버전으로 가리킨다면 B 페이지도 반드시 A(그리고 자기 자신 포함 전체 묶음)를 가리켜야 합니다. 한쪽만 선언하면 검색엔진은 그 hreflang 묶음 전체를 신뢰하지 않고 무시합니다. 실무에서는 모든 언어 버전이 동일한 hreflang 묶음을 공유하도록 하는 것이 가장 안전합니다. 즉 각 페이지의 <head>에 다음을 모두 넣습니다.
- 자기 자신을 포함한 모든 언어 버전의
hreflang링크 - (선택)
x-default링크 하나
x-default와 절대 URL 권장
x-default는 어떤 언어·지역에도 명시적으로 매칭되지 않는 방문자에게 보여줄 기본 페이지를 뜻합니다. 보통 언어 선택 화면이나 글로벌 영문 페이지를 지정합니다. 필수는 아니지만 매칭되지 않는 사용자 경험을 통제할 수 있어 권장됩니다.
href에는 항상 절대 URL(https://로 시작하는 정규 주소)을 쓰세요. 상대 경로는 hreflang에서 정상 동작하지 않으며, 각 URL은 해당 페이지의 canonical(정규) URL과 일치해야 합니다. 프로토콜·도메인·끝 슬래시까지 정확히 맞추는 것이 좋습니다.
- 각 언어·지역마다 코드와 절대 URL을 한 행씩 입력합니다.
- 필요하면
x-default행을 추가해 기본 페이지를 지정합니다. - 생성된
<link>묶음을 복사해 모든 언어 버전의<head>에 동일하게 넣습니다.
삽입 후에는 SEO 메타 태그 점검으로 각 페이지의 canonical과 hreflang이 실제 HTML에 의도대로 들어갔는지 확인하세요.