---
url: "/ko/copydoc/sync/spreadsheet-file.md"
description: "스프레드시트를 `.csv` 또는 `.xlsx` 파일로 만들었다면, CopyDoc 플러그인 메인 화면에서 **Sync Content** 버튼을 클릭해 이 기능의 설정 패널을 열고 Figma 디자인과 동기화할 수 있어요."
---

# CSV/XLSX 파일로 Figma에 콘텐츠 동기화

> 스프레드시트를 `.csv` 또는 `.xlsx` 파일로 만들었다면, CopyDoc 플러그인 메인 화면에서 **Sync Content** 버튼을 클릭해 이 기능의 설정 패널을 열고 Figma 디자인과 동기화할 수 있어요.

### 영상 튜토리얼: XLSX Excel 스프레드시트 콘텐츠를 Figma에 동기화

이 영상에서는 CopyDoc 플러그인으로 Excel 스프레드시트의 콘텐츠를 Figma 디자인에 동기화하는 방법을 보여 줘요.
[Embedded media](https://www.youtube-nocookie.com/embed/7YmbMj8LGXI)

### 영상 튜토리얼: CSV 스프레드시트 콘텐츠를 Figma에 동기화

이 영상에서는 CopyDoc 플러그인으로 CSV 스프레드시트의 콘텐츠를 Figma 디자인에 동기화하는 방법을 보여 줘요.
[Embedded media](https://www.youtube-nocookie.com/embed/5qdxq629A48)

### 영상 튜토리얼: 스프레드시트로 Figma 레이어 자동 반복 및 동기화

이 영상에서는 CopyDoc 플러그인으로 스프레드시트에서 Figma 레이어를 자동으로 반복하고 동기화하는 방법을 보여 줘요.
[Embedded media](https://www.youtube-nocookie.com/embed/_1MHyfYNHFQ)

### 영상 튜토리얼: 스프레드시트로 이미지 폴더를 Figma 레이어에 동기화

이 영상에서는 CopyDoc 플러그인으로 스프레드시트를 사용해 이미지 폴더를 Figma 레이어와 동기화하는 방법을 보여 줘요.
[Embedded media](https://www.youtube-nocookie.com/embed/4JV01bi8nOw)

### 영상 튜토리얼: 스프레드시트의 SVG 아이콘을 Figma 레이어에 동기화

이 영상에서는 CopyDoc 플러그인으로 스프레드시트의 SVG 아이콘을 Figma 레이어에 동기화하는 방법을 보여 줘요.
[Embedded media](https://www.youtube-nocookie.com/embed/eybeymh7IdQ)

## CSV 또는 XLSX 파일 콘텐츠를 Figma 레이어에 동기화 {#syncing-your-csv-or-xlsx-file-content-to-figma-layers}

[Video](/assets/videos/copydoc/sync/xlsx-sync.mp4)

올바르게 구성한 `.csv` 또는 `.xlsx` 파일을 **Sync XLSX/CSV File** 드롭 영역에 끌어다 놓거나, 이 영역을 클릭해 내 컴퓨터에서 파일을 직접 찾아 선택하면 스프레드시트 내용을 미리 볼 수 있어요.

스프레드시트 헤더와 일치하도록 이름을 바꾼 레이어가 들어 있는 레이어를 Figma에서 하나 이상 선택한 다음, **Sync Rows with Layers** 버튼을 클릭하세요(**Auto Repeat**가 켜져 있으면 **Sync & Repeat Selected Layer**). 스프레드시트의 콘텐츠가 이름을 바꾼 선택한 Figma 레이어와 동기화돼요.

> **Warning:** **폰트가 누락된 Figma 텍스트 레이어는 업데이트할 수 없어요.** Figma 텍스트 레이어에 [누락된 폰트](https://help.figma.com/hc/en-us/articles/360039956994-Manage-missing-fonts)가 있으면 플러그인이 해당 레이어를 업데이트할 수 없어요. CopyDoc 플러그인으로 어떤 방식으로든 업데이트하려는 텍스트 레이어는 누락된 폰트 문제를 먼저 해결해 주세요.

## 스프레드시트 행으로 Figma 레이어 하나를 자동 반복하기 {#auto-repeat-a-single-figma-layer-with-your-spreadsheet-rows}

[Video](/assets/videos/copydoc/sync/auto-repeat-sync.mp4)

**Content** 또는 **Styles** 동기화 탭 옵션을 사용할 때 **Auto Repeat** 토글을 켜면 Figma 레이어 하나를 자동으로 반복할 수 있어요. 처음 선택한 Figma 레이어를 스프레드시트 데이터의 행 수만큼 자동으로 복제해요.

이 기능으로 카드, 카탈로그 항목, 캠페인 레이아웃 하나를 스프레드시트 행마다 콘텐츠가 채워진 디자인으로 만들 수 있어요. 디자인 안의 텍스트 레이어와 이미지 레이어에는 일치하는 스프레드시트 열의 값이 들어가요.

메인 컴포넌트를 선택하면 CopyDoc이 행마다 인스턴스를 만들어요. 기존 인스턴스를 선택하면 그 인스턴스를 복제하고, 프레임을 선택하면 프레임을 복제해요.

선택한 Figma 레이어가 이미 Auto Layout이 켜진 다른 Figma 레이어 바로 안에 있다면, 선택한 레이어가 그 부모 레이어 안에서 자동으로 복제돼요. 그렇지 않으면 CopyDoc이 완전히 새로운 Auto Layout 프레임을 만들고 그 안에 새 Figma 레이어를 복제해요.

### 자동 반복되는 부모 레이어의 동적 이름 {#dynamic-auto-repeating-parent-layer-names}

[Video](/assets/videos/copydoc/sync/auto-renaming-frames.mp4)

복제된 각 Figma 레이어의 이름을 스프레드시트에서 가져오려면 선택한 템플릿 레이어의 이름을 열 머리글과 맞추세요. CopyDoc은 각 행에서 해당 열의 값을 새 레이어 이름으로 사용해요.

맨 앞의 `#` 하나는 있어도 되고 없어도 돼요. `#Title`이라는 레이어는 `Title` 열과 일치할 수 있고, `Title`이라는 레이어는 `#Title` 열과 일치할 수 있어요. 두 머리글이 모두 있으면 값이 비어 있더라도 정확히 일치하는 쪽이 우선해요. 대소문자와 공백은 여전히 일치해야 해요.

스프레드시트에 일치하는 레이어 이름이 없으면 CopyDoc 플러그인은 원래 Figma 레이어 이름에 행 번호를 붙여 사용해요(예: `My Frame Layer (Row 3)`).