퍼블리싱 & 라이브러리

복사 컴포넌트 라이브러리 업데이트

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

질문사항

기존 컴포넌트 라이브러리를 복사하여 수정한 후, 이 복사된 라이브러리를 페이지에 연결했는데 컴포넌트가 자동으로 업데이트되지 않습니다. 이 경우 컴포넌트를 하나하나 재연결해야 하나요?

답변

네, 기존 컴포넌트 라이브러리를 복사하여 사용하면 원본 라이브러리와는 별개의 새로운 파일이 되기 때문에, 컴포넌트 ID가 달라져 자동으로 업데이트되지 않습니다. 이 때문에 기존 파일에 연결된 인스턴스들이 복사된 라이브러리의 컴포넌트를 자동으로 참조하지 못하는 것입니다. 몇 가지 해결 방법이 있습니다.

원인:

Figma에서 파일을 복사하면, 그 안에 있는 모든 컴포넌트의 ID도 새로 생성됩니다. 따라서 원본 라이브러리의 컴포넌트와 복사된 라이브러리의 컴포넌트는 이름이 같더라도 시스템적으로는 다른 개체로 인식됩니다.

해결 방법:

새 라이브러리 발행 및 연결:

복사한 라이브러리 파일을 새로운 라이브러리로 발행(Publish)합니다.

작업 중인 파일에서 기존 라이브러리 연결을 해제하고, 새로 발행한 라이브러리를 연결합니다.

이후, `Library Swap` 기능을 사용하여 기존 컴포넌트 인스턴스들을 새로 연결된 라이브러리의 동일 명칭 컴포넌트로 일괄 교체할 수 있습니다. 이 방법은 컴포넌트의 이름이 원본과 동일하게 유지될 때 가장 효과적입니다.

플러그인 활용:

`Reattach Instance`: 이 플러그인은 선택한 인스턴스를 다른 마스터 컴포넌트에 다시 연결하는 데 도움을 줍니다. 컴포넌트의 양이 많지 않거나 특정 인스턴스만 재연결해야 할 때 유용합니다.

`Master` (일부 기능 무료): 이 플러그인은 마스터 컴포넌트 관리 및 인스턴스 재연결에 도움을 줄 수 있습니다. 복잡한 컴포넌트 구조를 다룰 때 유용할 수 있습니다.

수동 재연결 (소량의 경우):

컴포넌트 인스턴스의 수가 적다면, 각 인스턴스를 선택한 후 디자인 패널의 'Instance' 섹션에서 드롭다운 메뉴를 통해 수동으로 새로운 마스터 컴포넌트를 찾아 연결할 수 있습니다.

권장 사항:

디자인 시스템이나 라이브러리를 관리할 때는 원본 파일을 직접 수정하고 버전을 관리하는 것이 가장 좋습니다. 복사본을 만들어 수정하는 방식은 위와 같은 연결 문제와 함께 버전 관리의 복잡성을 야기할 수 있습니다. 불가피하게 복사본을 사용해야 한다면, `Library Swap` 기능을 활용하는 것이 가장 효율적인 방법입니다.