컴포넌트 & 인스턴스

마스터 컴포넌트 이동 연결 유지

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

질문사항

디자인 작업 파일에 있는 마스터 컴포넌트를 디자인 시스템 파일로 옮기려고 합니다. 이 경우 인스턴스와 마스터 컴포넌트의 연결이 끊어져 'Restore component' 메시지가 뜨는데, 마스터 컴포넌트를 어떻게 옮겨야 연결이 유지될까요?

답변

디자인 작업 파일의 마스터 컴포넌트를 디자인 시스템 파일로 옮기면서 기존 인스턴스와의 연결을 유지하는 가장 좋은 방법은 라이브러리 발행(Publishing Library) 기능을 활용하는 것입니다.

절차는 다음과 같습니다:

디자인 시스템 파일에 컴포넌트 생성: 디자인 시스템 파일에 옮기고자 하는 컴포넌트와 동일한 이름으로 마스터 컴포넌트를 생성합니다. (이때, 기존 작업 파일의 마스터 컴포넌트를 복사하여 붙여넣는 방식으로 시작할 수 있습니다.)

라이브러리 발행: 디자인 시스템 파일을 라이브러리로 발행(Publish)합니다.

라이브러리 활성화: 기존 디자인 작업 파일에서 발행된 디자인 시스템 라이브러리를 활성화합니다.

Swap Library: 기존 디자인 작업 파일에서 'Restore component' 메시지가 뜨는 인스턴스들을 선택한 후, Figma 메뉴에서 `Component > Swap Library` 기능을 사용하여 새로 발행된 디자인 시스템 라이브러리의 컴포넌트로 교체(Swap)합니다.

이 과정을 통해 인스턴스의 오버라이드는 유지하면서 마스터 컴포넌트의 출처를 디자인 시스템 파일로 변경할 수 있습니다.