컴포넌트 관리

마스터 컴포넌트 라이브러리 이동 문제

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

질문사항

마스터 컴포넌트를 다른 라이브러리로 옮길 때 인스턴스의 연결이 끊기는 문제가 발생합니다. 제가 사용하는 방법(1. 디자인 파일에서 컴포넌트 이동 전 퍼블리시, 2. 잘라내기 후 다른 라이브러리에 붙여넣기, 3. 라이브러리 퍼블리시)으로 진행해왔는데, 갑자기 작동하지 않습니다. 해결 방법이 궁금합니다.

답변

마스터 컴포넌트를 다른 라이브러리로 옮길 때 인스턴스 연결을 유지하는 방법은 다음과 같습니다:

기존 라이브러리 파일과 새 라이브러리 파일을 모두 엽니다.

기존 라이브러리에서 이동할 마스터 컴포넌트를 잘라내기(Cut) 합니다. (Ctrl/Cmd + X)

새 라이브러리 파일에 붙여넣기(Paste) 합니다. (Ctrl/Cmd + V)

두 라이브러리 파일 모두 'Assets' 패널에서 'Publish changes...'를 클릭하여 변경 사항을 퍼블리시합니다.

새 라이브러리 파일의 퍼블리시 탭에서, 기존 라이브러리에 있던 컴포넌트가 새 라이브러리로 이동되었음을 알리는 'Move to this file' 또는 유사한 메시지가 나타날 수 있습니다. 이를 확인하고 퍼블리시를 진행합니다.

인스턴스를 사용하고 있는 디자인 파일에서 라이브러리 업데이트 알림이 뜨면 업데이트를 진행합니다. (Assets 패널 상단의 'Update available' 클릭)

이 과정을 통해 인스턴스의 연결이 자동으로 새 라이브러리의 마스터 컴포넌트로 변경됩니다. 만약 이 과정이 원활하지 않다면, Figma를 재시작하거나 브라우저 캐시를 지워보는 것도 도움이 될 수 있습니다.