Figmapedia
목록으로 돌아가기
컴포넌트 & 인스턴스

컴포넌트 스왑 라이브러리 오류

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

질문사항

작업 파일 내 컴포넌트를 디자인 시스템 파일로 옮겨 퍼블리시한 후, 작업 파일에서 스왑 라이브러리를 사용하려는데 'no items to swap'이라고 뜨는 이유는 무엇인가요?

답변

컴포넌트 스왑 시 'no items to swap' 메시지가 뜨는 주된 이유는 다음과 같습니다:
  • 컴포넌트 이름 일치: 스왑하려는 컴포넌트들의 이름이 정확히 일치해야 합니다. (예: `Button/Primary`와 `Button/Primary`)
  • 라이브러리 발행 및 활성화: 디자인 시스템 파일이 라이브러리로 발행(Publish)되었고, 작업 파일에서 해당 라이브러리가 활성화(Enabled)되어 있어야 합니다.
  • 스왑 라이브러리 사용: 작업 파일에서 스왑하려는 인스턴스를 선택한 후, 오른쪽 사이드바의 'Instance' 섹션에서 드롭다운 메뉴를 통해 다른 라이브러리의 동일 이름 컴포넌트로 스왑할 수 있습니다. 만약 로컬 컴포넌트를 디자인 시스템 컴포넌트로 바꾸고 싶다면, 로컬 컴포넌트의 이름을 디자인 시스템 컴포넌트와 동일하게 변경한 후, 해당 인스턴스를 선택하고 'Swap library' 기능을 사용해야 합니다.