퍼블리싱 & 라이브러리

인스턴스 컴포넌트 미업데이트 문제

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

질문사항

피그마 퍼블리싱 후 인스턴스 컴포넌트가 업데이트되지 않고 이전 버전 이름을 유지하는 문제가 발생합니다. 원인과 해결 방법이 궁금합니다.

피그마에서 라이브러리를 퍼블리시했는데 인스턴스가 업데이트되지 않거나 이전 버전 이름을 가지고 있다면, 다음 점검 순서를 따라 문제를 해결할 수 있습니다.

✅ 퍼블리시 직전 업데이트 확인

라이브러리를 퍼블리시하기 전에, 해당 파일에서 `Assets` 패널 상단의 `Update from library` 버튼을 눌러 최신 상태로 맞춰두세요.

오래된 인스턴스가 파일 내에 남아있으면, 새 버전 퍼블리시 후에도 반영이 꼬일 수 있습니다.

🧩 컴포넌트 연결 문제

업데이트되지 않는 인스턴스를 선택한 후, 오른쪽 사이드바의 `Component` 섹션에서 `Go to Main Component` 아이콘(다이아몬드 모양)을 클릭하여 메인 컴포넌트로 이동되는지 확인합니다.

만약 이동되지 않는다면, 인스턴스와 메인 컴포넌트의 연결이 끊긴 상태일 수 있습니다.

`Assets` 패널 > `Libraries` 탭에서 해당 라이브러리를 껐다가 다시 켜보세요. (라이브러리 토글 버튼)

🌐 네트워크 / 캐시 문제

퍼블리시 반영이 즉시 안 될 경우, 피그마 앱을 새로고침(`Cmd/Ctrl + R`)하거나 완전히 종료 후 재시작해 보세요.

브라우저에서 피그마를 사용하는 경우, 브라우저 캐시를 삭제하면 해결되는 경우도 있습니다.

📦 퍼블리시 미완료

메인 컴포넌트를 수정했지만, `Assets` 패널 상단의 `Publish changes` 버튼을 누르지 않은 경우 인스턴스는 이전 버전을 유지합니다.

수정 사항을 라이브러리에 반영하려면 반드시 `Publish changes` 버튼을 클릭해야 합니다.

🪞 이름 변경만 한 경우

인스턴스의 이름은 메인 컴포넌트의 이름과 자동으로 동기화되지 않습니다. 인스턴스 자체의 이름은 사용자가 변경할 수 있으며, 이는 메인 컴포넌트 업데이트와는 별개입니다.

만약 메인 컴포넌트의 이름이 변경되었더라도, 기존 인스턴스의 이름은 수동으로 변경해야 합니다.