Getting Started
2025. 7. 22.
자동 로케일(Auto Locale) 기능 이해하기
사용자의 브라우저 언어 설정에 따라 사이트 방문 시 자동으로 적절한 언어 버전으로 리디렉션하는 Framer의 Auto Locale 기능을 알기 쉽게 설명합니다.

Posted By
Framer Space
목차
Table of Contents
본 문서는 Framer를 배우는 국내 사용자들이 한글 자료의 부족으로 겪는 어려움을 해결하고자, 공식 블로그의 내용을 한국어로 번역하고 실무에 유용한 정보를 추가했습니다. 프레이머를 사용하는 여러분께 작게나마 도움이 되길 바랍니다.
자동 로케일(Auto Locale)이란?
사용자가 웹사이트에 접속하면, 브라우저의 언어 설정을 확인해 해당 언어 또는 지역(locale) 버전으로 자동 이동시키는 기능입니다. 여기서 말하는 '로케일'은 단순한 국가 설정이 아니라, 언어(Language)와 지역(Region)의 조합을 의미해요.
즉, 어떤 언어를 어떤 지역 버전으로 보여줄지 구체적으로 지정하는 값이에요. 그래서 이 기능은 사용자의 브라우저 언어 설정을 바탕으로, 가능한 가장 적절한 언어 페이지로 자동 안내해줍니다. 이를 통해 사용자 경험(UX)을 한층 향상할 수 있어요.
설정 방법
사이트의 설정(Settings) → Auto Locale 섹션으로 이동
토글 버튼을 ON으로 켜기

Note
: 도메인이 정시(AKA canonical)인 경우에만 작동하미로, 커스텀 도메인을 사용하는 경우 해당 도메인이 설정된 도메인인지 확인하세요.
언제 작동하나요?
Canonical 도메인에서만 동작합니다. (예:
example.com
)리버스 프록시 등을 통해 설정한 canonical 대체 도메인일 경우에도 여전히 작동합니다.
자동 로케일은 어떻게 결정되나요?
자동 로케일은 지리적 위치를 사용하지 않고, 브라우저 언어 설정을 기준으로 작동합니다.
(사용자의 위치(IP) 정보는 사용하지 않습니다.)기본 언어로 설정된 페이지에 접속했을 때만 자동 리디렉션이 일어나요.
예: 사이트의 기본 언어가 영어(en
)일 때example.com
에 접속하면, 사용자의 브라우저 언어가es-MX
라면example.com/es-MX
로 자동 이동해요.
반대로example.com/fr
처럼 이미 특정 언어 버전으로 접속한 경우에는 자동 전환되지 않아요.브라우저에 설정된 언어 우선순위대로 순서대로 확인해요.
먼저 정확히 일치하는 언어+지역(locale)을 찾고,
예: 브라우저 언어가es-MX
이면es-MX
페이지로 이동정확한 매칭이 없을 땐 일반 언어(locale)로 넘어가요.
예:es-MX
가 없으면es-ES
, 그것도 없으면 그냥es
페이지로 이동
문제가 있다면?
Auto Locale 기능이 켜져 있지 않거나 기본이 아닌 도메인에서 접근하는 경우
사이트가 canonical 도메인이 아닐 때
브라우저 언어 설정이 올바르지 않거나 사이트에 정의된 locale과 일치하지 않는 경우
이런 경우 해당 기능이 작동하지 않을 수 있으며, Framer 지원 페이지로 연락해 도움을 요청할 수 있어요.
본 글은 Framer 공식 블로그의 ‘How does Automatic Locale work’을 번역·각색한 콘텐츠입니다.