사용 방법
- 언어별 주소에 같은 내용을 언어별로 만든 페이지를
언어코드 주소형식으로 한 줄씩 적습니다. 예:ko https://example.com/ko/ - 출력 방식을 고릅니다. 보통은 HTML link 태그를 쓰고, 페이지가 많거나 head를 고치기 어려우면 사이트맵 XML, PDF 같은 파일에는 HTTP 헤더를 씁니다.
- 기본 페이지가 있다면 x-default 줄 자동 추가를 켜고 어느 언어 주소를 기본으로 할지 고릅니다.
- 결과를 복사해 모든 언어 페이지에 똑같이 넣습니다.
hreflang이 하는 일
같은 내용을 여러 언어로 제공할 때, 검색엔진에 “이 페이지의 다른 언어 버전은 여기 있다”고 알려 주는 표시입니다. 한국어 사용자에게는 한국어 페이지를, 미국 영어 사용자에게는 영어 페이지를 보여 주도록 돕고, 번역 페이지끼리 중복 콘텐츠로 오해받는 일을 줄입니다.
<link rel="alternate" hreflang="ko" href="https://example.com/ko/" />
<link rel="alternate" hreflang="en-US" href="https://example.com/en/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/" />
꼭 지켜야 할 규칙
- 서로 가리키기: A 페이지가 B를 가리키면 B도 A를 가리켜야 합니다. 한쪽만 있으면 무시될 수 있어요. 그래서 이 도구의 결과 전체를 모든 언어 페이지에 똑같이 넣습니다.
- 자기 자신 포함: 각 페이지의 목록에는 자기 자신의 주소도 들어 있어야 합니다.
- 전체 주소:
/en/이 아니라https://example.com/en/처럼 http나 https로 시작하는 전체 주소를 씁니다. - 언어 코드 하나에 주소 하나: 같은 코드를 두 번 쓰면 안 됩니다. 중복되면 오류로 알려 줍니다.
언어·지역 코드 쓰는 법
형식은 언어 또는 언어-지역입니다. 언어는 ISO 639-1 두 글자(소문자), 지역은 ISO 3166-1 두 글자(대문자)입니다. 대소문자는 자동으로 맞춰 줘요.
| 하려는 것 | 올바른 코드 | 흔한 실수 |
|---|---|---|
| 한국어 | ko |
kr, ko-kr(동작은 하지만 지역 구분이 필요 없다면 ko로 충분) |
| 일본어 | ja |
jp |
| 중국어 간체 / 번체 | zh-Hans / zh-Hant |
cn, zh-cn만 쓰는 경우 |
| 영국 영어 | en-GB |
en-UK |
| 미국 영어 | en-US |
us |
| 언어는 다르지만 기본 페이지 | x-default |
빠뜨림 |
us처럼 지역만 쓴 코드는 언어 코드가 아니라서 쓸 수 없습니다. 이 도구는 jp, cn, en-UK 같은 실수를 찾아 알맞은 코드를 알려 줍니다. 단, kr은 카누리어를 뜻하는 실제 ISO 코드라 오류가 아닌 경고로 보여 줍니다.
세 가지 출력 방식
- HTML link 태그: 각 페이지
<head>안에 넣습니다. 가장 일반적입니다. - 사이트맵 XML:
sitemap.xml의<url>마다xhtml:link로 모든 언어 주소를 나열합니다. 페이지 수가 많을 때 관리가 쉽습니다. 주소&는 자동으로&로 바뀝니다. - HTTP 헤더:
Link: <주소>; rel="alternate"; hreflang="ko", ...형태입니다. HTML이 아닌 PDF 같은 파일에 씁니다.
세 방식 중 하나만 쓰면 됩니다. 같은 정보를 여러 방식으로 중복해 넣으면 충돌 위험만 커집니다.
자주 묻는 질문
x-default는 꼭 넣어야 하나요?
필수는 아니지만 권장합니다. 사용자의 언어에 맞는 버전이 없을 때 보여 줄 기본 페이지(언어 선택 화면이나 영어 페이지)를 지정합니다.
한국어 페이지는 ko와 ko-KR 중 무엇을 쓰나요?
한국어 페이지가 하나뿐이라면 ko로 충분합니다. 한국어 지역별 버전을 따로 만들 때만 ko-KR처럼 지역을 붙이세요.
지원하는 언어 코드는 어디까지 검사하나요?
언어 부분은 ISO 639-1 두 글자 목록에 있는지 확인하고, 세 글자 코드(fil 등)는 형식만 봅니다. 지역 코드는 형식만 확인합니다.
canonical과 같이 써도 되나요?
네. 각 언어 페이지는 자기 자신을 canonical로 가리키는 것이 일반적입니다. 번역 페이지를 한 언어의 canonical로 모으면 hreflang이 무시됩니다.
입력한 주소가 서버로 가나요?
아니요. 주소는 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.