> ## Documentation Index
> Fetch the complete documentation index at: https://make.edicus.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 라이브러리

> 상품 설정에서 고르는 편집 템플릿, 가이드 이미지, 3D 모델 파일을 올리고 정리하기

라이브러리는 상품 설정에서 골라 쓰는 파일을 모아 두는 곳입니다. 편집 템플릿, 가이드 이미지, 3D 모델 세 종류를 올리고 폴더로 정리합니다. 여기 올린 파일은 상품의 **옵션 설정**과 **편집기 설정**에서 **보관함에서 선택**으로 고릅니다.

## 배우는 것

* 라이브러리에 올리는 파일 세 종류와 각각 쓰이는 곳
* 파일 형식과 올릴 때 확인하는 것
* 파일 올리기, 교체, 삭제
* 폴더로 파일 정리하기
* 상품 설정에서 라이브러리 파일 고르기

## 라이브러리 열기

왼쪽 메뉴 **판매 관리**에서 **상품 연동**과 상품 폴더 아래에 있는 **라이브러리**를 누릅니다. PC 화면에서 씁니다. 휴대폰 화면의 메뉴에는 나오지 않습니다.

화면은 세 칸으로 나뉩니다.

| 칸 | 내용 |
| - | - |
| 왼쪽 | **종류**(**전체**, **편집 템플릿**, **가이드 이미지**, **3D 모델**)와 **폴더**(**전체 폴더**, 만든 폴더, **미분류**). 이름 옆 숫자는 파일 수입니다. 아래 **새 폴더**로 폴더를 만듭니다 |
| 가운데 | 고른 종류와 폴더의 파일 목록. 위쪽에서 **이름, 폴더 검색**으로 찾고, 오른쪽 정렬 메뉴에서 **최신순**, **오래된순**, **이름 오름차순**, **이름 내림차순**을 고릅니다 |
| 오른쪽 | 가운데에서 누른 파일의 상세. 큰 미리보기와 **종류**, **형식**, **폴더**, **등록일**이 나옵니다 |

칸 사이 경계를 끌면 너비를 바꿀 수 있습니다. 한 번에 최근 파일 1,000개까지 보여 줍니다. 그보다 많으면 목록 아래에 안내가 나오니 검색이나 폴더로 범위를 좁히세요.

## 파일 종류

| 종류 | 형식 | 무엇인가 | 쓰이는 곳 |
| - | - | - | - |
| **편집 템플릿** | SVG | 구매자 편집기가 여는 SVG 템플릿입니다. 칼선과 목업 레이어를 담습니다 | 상품 **옵션 설정**에서 옵션 조합의 편집 템플릿을 고르는 항목 |
| **가이드 이미지** | PNG, JPG | 구매자에게 보여 줄 안내 이미지입니다 | 상품 **편집기 설정** 탭의 **가이드 설정** |
| **3D 모델** | GLTF, GLB | 3D 미리보기에 쓰는 모델 파일입니다 | 상품 **옵션 설정**에서 옵션 조합의 3D 모델을 고르는 항목 |

편집 템플릿과 3D 모델을 고르는 항목은 상품 유형에 따라 옵션 설정에 나오기도 하고 나오지 않기도 합니다. 라이브러리에는 이 세 종류만 올립니다.

## 파일 올리기

**1. 파일 업로드를 누릅니다**

화면 맨 위의 **파일 업로드**를 누릅니다. 왼쪽에서 **전체**를 보고 있으면 먼저 **편집 템플릿 업로드**, **가이드 이미지 업로드**, **3D 모델 업로드** 가운데 하나를 고릅니다. 특정 종류를 보고 있으면 그 종류로 바로 올립니다.

**2. 파일을 고릅니다**

"파일을 끌어다 놓거나 선택하세요" 영역에 파일을 끌어 놓거나 **파일 선택**을 누릅니다. 여러 파일을 한 번에 올릴 수 있고, **파일 추가**로 더 담을 수 있습니다. 형식이 맞지 않거나 이미 담은 이름의 파일은 빠지고 알림이 뜹니다.

**3. 미리보기와 폴더를 확인합니다**

왼쪽 목록에서 파일을 누르면 오른쪽에 미리보기가 나옵니다. 아래 **폴더**에서 넣을 폴더를 고릅니다. 지금 보고 있던 폴더가 미리 골라져 있고, 고른 폴더는 올리는 파일 전부에 적용됩니다. 목록에 없는 폴더는 **새 폴더**로 바로 만들 수 있습니다.

**4. 모든 파일 업로드를 누릅니다**

파일을 차례로 올립니다. 일부만 실패하면 성공한 파일은 올라가고 창이 닫히며, 실패한 개수가 알림으로 뜹니다. 실패한 파일은 다시 올리세요. 모두 실패하면 창이 닫히지 않고 파일마다 실패 이유가 남습니다.

### 올릴 때 확인하는 것

| 확인 | 내용 |
| - | - |
| 확장자 | 종류마다 정해진 확장자만 받습니다. 편집 템플릿은 SVG, 가이드 이미지는 PNG와 JPG(JPEG), 3D 모델은 GLTF와 GLB입니다 |
| SVG 안의 이미지 크기 | 편집 템플릿 SVG 안에 넣은 이미지(`<image>` 요소)의 가로나 세로가 1800px를 넘으면 **업로드 불가**가 뜨고 올릴 수 없습니다. 이미지를 줄여 다시 저장하세요 |

편집 템플릿 SVG가 에디쿠스 템플릿 구조이면 미리보기 위쪽 **레이어** 줄에 파일에서 찾은 레이어(칼선, 목업 등)가 버튼으로 나옵니다. 버튼을 눌러 레이어를 켜고 끄며 제대로 들어 있는지 확인할 수 있고, **3D 보기**로 입체로 볼 수도 있습니다. 에디쿠스 템플릿 구조가 아니면 **일반 SVG**로 표시됩니다.

## 파일 다루기

가운데 목록에서 파일을 누르면 오른쪽 상세 칸에 버튼이 나옵니다.

| 버튼 | 하는 일 |
| - | - |
| **크게 보기** | 파일을 큰 창으로 봅니다 |
| **폴더 이동** | 파일을 다른 폴더로 옮깁니다. 파일 주소는 바뀌지 않으므로 이 파일을 쓰는 상품 설정도 그대로입니다 |
| **파일 교체** | 같은 종류의 새 파일로 바꿉니다. 이름과 폴더는 그대로 유지됩니다 |
| **URL 복사** | 파일의 공개 주소를 복사합니다 |
| **다운로드** | 원본 파일을 내려받습니다 |

> [!NOTE]
>
> **URL 복사**로 얻는 주소는 공개 주소입니다. 주소를 아는 사람은 로그인하지 않고도 파일을 열 수 있습니다.

### 파일 교체

**파일 교체**는 파일 주소를 그대로 두고 내용만 새 파일로 바꿉니다. 그래서 이 파일을 고른 상품을 다시 설정하지 않아도, 그 뒤로 여는 편집기는 새 파일을 씁니다.

> [!WARNING]
>
> **판매중**인 상품이 쓰는 파일을 교체하면 그 뒤 구매자가 여는 편집기에도 새 파일이 쓰입니다. 교체한 뒤에는 상품 상세 화면의 **편집기 미리보기**로 결과를 확인하세요. [상품 연동](/docs/link/products.md#편집기-미리보기)

### 여러 파일 한꺼번에 다루기

목록 왼쪽 체크박스로 파일을 고르면 위쪽에 **N개 선택됨** 줄이 나옵니다. **폴더 이동**으로 한꺼번에 옮기거나 **삭제**로 한꺼번에 지웁니다. **선택 해제**로 고른 것을 풉니다.

### 파일 삭제

파일은 체크박스로 고른 뒤 **삭제**로 지웁니다. 지운 파일은 되돌릴 수 없습니다.

지우기 전에 고른 파일이 상품 설정에서 쓰이는지 확인합니다. 쓰이는 파일이 있으면 **연결된 상품이 있습니다** 창에 파일마다 쓰는 상품 이름이 나옵니다. 그래도 지우면 그 상품과 파일의 연결이 끊어집니다.

확인 대상은 두 곳입니다.

* 옵션 설정에서 **편집링크를 보냅니다**로 정한 옵션 조합에 고른 편집 템플릿과 3D 모델
* **가이드 이미지 사용**을 켜 둔 가이드 설정의 가이드 이미지

> [!WARNING]
>
> 연결이 끊어진 상품은 편집기가 그 파일을 불러오지 못합니다. **판매중**인 상품이 쓰는 파일은 지우기 전에 상품 설정에서 다른 파일로 바꿔 두세요.

## 폴더로 정리하기

폴더는 파일을 정리하기 위한 분류입니다. 파일 주소에는 들어가지 않으므로, 폴더를 만들고 옮기고 지워도 상품 설정은 바뀌지 않습니다. 폴더에 넣지 않은 파일은 **미분류**에 모입니다.

| 하려는 일 | 방법 |
| - | - |
| 폴더 만들기 | 왼쪽 칸 아래 **새 폴더**를 누르고 이름을 입력합니다. 이름은 24자까지입니다. **폴더 이동** 창과 업로드 창에서도 바로 만들 수 있습니다 |
| 파일 옮기기 | 상세 칸의 **폴더 이동**, 또는 여러 파일을 고른 뒤 **폴더 이동**. 창에서 폴더를 고릅니다 |
| 폴더 이름 바꾸기 | 왼쪽 칸에서 폴더에 마우스를 올리고 오른쪽 메뉴에서 **이름 변경**을 고릅니다 |
| 폴더 지우기 | 같은 메뉴에서 **폴더 삭제**를 고릅니다. 안에 있던 파일은 지워지지 않고 **미분류**로 옮겨집니다 |

## 상품 설정에서 파일 고르기

상품의 **옵션 설정**이나 **편집기 설정**에서 파일을 넣는 항목에는 **보관함에서 선택** 버튼이 있습니다.

**1. 보관함에서 선택을 누릅니다**

**편집 템플릿 고르기**처럼 그 항목의 종류 이름이 붙은 창이 열립니다. 그 종류의 파일만 나옵니다.

**2. 파일을 고르거나 새로 올립니다**

**선택** 탭에서 폴더와 검색으로 파일을 찾아 고릅니다. 라이브러리에 없는 파일은 **업로드** 탭에서 한 개씩 올리면 라이브러리에 저장되고 바로 골라집니다.

**3. 상품을 저장합니다**

고른 파일은 상품의 미저장 변경으로 잡힙니다. 화면 맨 위 저장 바의 **저장**을 눌러야 상품에 반영됩니다.

창 오른쪽 위 **관리 페이지**를 누르면 라이브러리가 새 탭에서 열립니다. 파일을 정리하거나 교체할 때 씁니다.

파일 대신 주소를 직접 넣어야 하면 항목 옆 **주소 직접 입력**을 켜고 입력합니다.

## 됐는지 확인

> [!TIP]
>
> 상품 상세 화면에서 **보관함에서 선택**을 눌렀을 때 올린 파일이 보이고, 고른 뒤 저장한 상품을 **편집기 미리보기**로 띄웠을 때 그 파일이 편집기에 나오면 준비가 끝난 것입니다.

## 다음 단계

> **[옵션 설정](/docs/link/options.md)**
>
> 옵션 조합마다 편집 템플릿과 편집기 설정을 연결합니다.

> **[상품 연동](/docs/link/products.md)**
>
> 상품 상세 화면의 탭과 편집기 미리보기를 봅니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.