베리어블 & 디자인 시스템퍼블리싱 & 라이브러리컴포넌트 관리

라이브러리 퍼블리싱 시 변수 발행 범위

피그마 오픈카톡방2026. 3. 7.

질문사항

Figma 라이브러리 퍼블리싱 시, 제가 직접 작업한 변수(Variables)만 발행되는 건가요?

아닙니다. Figma 라이브러리로 발행(Publish)하는 변수(Variables)는 특정 작업자에 국한되지 않고, 해당 파일에 정의된 모든 변수가 발행될 수 있습니다. 다만, 변수가 라이브러리에 나타나지 않는다면 다음과 같은 경우를 확인해볼 수 있습니다.

'Hide from publishing' 옵션 체크 여부: 각 변수 컬렉션 또는 특정 변수에 'Hide from publishing' 옵션이 체크되어 있는지 확인해보세요. 이 옵션이 활성화되어 있으면 해당 변수는 라이브러리에 발행되지 않습니다.

`Local variables` 패널에서 변수 컬렉션 옆의 `...` 메뉴를 클릭하여 `Edit collection`으로 들어간 후, `Publishing` 섹션을 확인합니다.

변수 범위(Scope) 설정: 변수가 특정 모드나 범위에서만 작동하도록 설정되어 있고, 해당 범위가 라이브러리에서 제대로 인식되지 않을 수도 있습니다. 하지만 일반적으로는 'Hide from publishing' 옵션이 가장 흔한 원인입니다.

라이브러리 업데이트: 변수를 추가하거나 수정한 후에는 반드시 라이브러리를 다시 'Publish'해야 변경 사항이 다른 파일에서 업데이트됩니다.

라이브러리로 발행된 변수는 팀의 모든 디자이너가 일관된 디자인 토큰을 사용할 수 있도록 돕는 중요한 기능이므로, 설정이 올바른지 확인하는 것이 중요합니다.