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

# CSV로 QR 코드 만들기

> CSV를 업로드하고 디자인 하나를 선택해 한 번에 최대 100개의 Website QR 코드를 만드세요.

이 가이드에서는 **Create Bulk** 마법사를 단계별로 안내합니다. 링크를 추가하고, 디자인을 사용자 지정한 다음, 배치를 만듭니다.

## 시작하기 전에

* **Admin** 또는 **Editor** 역할이 필요합니다.
* 헤더가 `name,url`이고 행이 최대 100개인 CSV 파일을 준비하세요. [CSV 형식](/ko/bulk/csv-format)을 참고하세요.
* 워크스페이스에서 다른 배치가 실행 중이지 않아야 합니다.

## 1단계: 링크 추가

**1. Create Bulk 열기**

사이드바에서 **Create Bulk**를 클릭합니다. 휴대폰에서는 만들기 버튼을 탭하고 **Create bulk QRs**를 선택합니다.

**2. 템플릿 받기(선택 사항)**

올바른 헤더가 포함된 샘플 파일을 받으려면 **Download CSV template**을 클릭합니다.

**3. 파일 업로드**

CSV를 업로드 영역에 끌어다 놓거나, 업로드 영역을 클릭해 파일을 찾습니다. GetQR이 행을 확인하는 동안 "Reading CSV…"가 표시됩니다.

**4. 결과 검토**

모든 행이 유효하면 **All links look good**이 표시됩니다. 그렇지 않으면 수정이 필요한 행이 **MISSING** 또는 **INVALID** 배지와 함께 나열됩니다.

**5. 수정하거나 계속하기**

CSV를 수정한 후 **Replace**를 클릭해 다시 업로드합니다. 또는 **Continue**를 클릭해 유효한 코드만 만듭니다.

> [!NOTE]
>
> 오류가 있는 행은 건너뛰며 생성되지 않습니다. **Continue** 버튼에 배치에 포함될 코드 수가 표시됩니다.

## 2단계: 사용자 지정

**1. 디자인 선택**

**Custom designs**, **Branded designs**, **AI designs**, **My templates** 중 탭을 선택합니다. 디자인은 배치의 모든 코드에 적용됩니다.

**2. 디자인을 템플릿으로 저장(선택 사항)**

나중에 이 디자인을 재사용하려면 미리보기 아래에서 **Save as template**을 선택합니다.

**3. 계속**

**Continue**를 클릭합니다. 로고를 업로드했다면 먼저 업로드가 완료될 때까지 기다리세요.

> [!TIP]
>
> 대량 생성에서 저장한 템플릿에는 배치의 첫 번째 QR 코드 이름이 사용됩니다. 나중에 **QR Templates** 페이지에서 이름을 바꿀 수 있습니다.

## 3단계: 만들기

**1. 배치 검토**

요약 정보를 확인합니다: **Type**(Website / URL), **Source**(파일 이름), **Codes**(생성될 코드 수).

**2. 시작**

**Create N QR codes**를 클릭합니다. 여기서 N은 유효한 행의 수입니다.

**3. 진행 상황 확인**

GetQR이 코드를 만들고, 이미지를 렌더링하고, ZIP으로 묶습니다. 각 단계의 진행 상황이 표시됩니다.

**4. 다운로드**

**Your QR codes are ready**가 표시되면 **Download all (ZIP)** 버튼을 클릭합니다. [ZIP 다운로드](/ko/bulk/download-zip)를 참고하세요.

배치가 실행되는 동안 페이지를 벗어나도 됩니다. 진행 상황은 저장되며, 다시 돌아오면 **Create Bulk**에 다시 표시됩니다.

## 배치 상태

| 상태 | 의미 |
| - | - |
| **Queued** | 배치가 시작을 준비하고 있습니다. |
| **Creating QR codes** | 코드를 만들고 이미지를 렌더링하고 있습니다. |
| **Packaging archive** | 이미지를 ZIP으로 묶고 있습니다. |
| **Rolling back** | 배치가 중지되었거나 실패하여, 생성된 코드를 제거하고 있습니다. |
| **Completed** | 모든 코드가 생성되었고 ZIP이 준비되었습니다. |
| **Failed** | 배치가 완료되지 않았습니다. 이 배치의 코드는 하나도 남지 않았습니다. |

## 배치 중지하기

배치가 대기 중이거나 생성 또는 패키징 중일 때 **Stop creating**을 클릭합니다. GetQR이 이 배치에서 만든 모든 코드를 제거하고 **Bulk creation cancelled**를 표시합니다. 다시 시작하려면 **Start over**를 클릭합니다.

> [!WARNING]
>
> 중지하면 이미 생성된 코드를 포함해 배치 전체가 제거됩니다. 일부만 남겨 둘 수는 없습니다.

## 자주 발생하는 문제

> **Add links 단계에서 Continue가 비활성화되어 있습니다**
>
> 파일에 유효한 행이 하나도 없습니다. **MISSING** 또는 **INVALID**로 표시된 행을 수정하고 **Replace**를 클릭해 파일을 다시 업로드하세요.

> **"Wait for the logo upload to finish before continuing."가 표시됩니다**
>
> 로고가 아직 업로드 중입니다. 잠시 기다린 후 **Continue**를 클릭하세요.

> **Customize 단계에서 Continue에 Processing…이 표시됩니다**
>
> Branded 디자인 또는 AI 디자인을 아직 준비하고 있습니다. 완료될 때까지 기다리세요.

> **"This operation is taking longer than expected"가 표시됩니다**
>
> 진행 상황은 유지됩니다. 페이지를 열어 두거나, 나중에 **Create Bulk**를 통해 다시 돌아오세요.

> **"Bulk creation failed"가 표시됩니다**
>
> 배치가 롤백되어 코드가 하나도 남지 않았습니다. 오류 코드를 메모하고, 파일을 확인한 후 **Start over**를 클릭하세요. 다시 실패하면 오류 코드와 함께 [help@getqr.com](mailto:help@getqr.com)으로 문의하세요.

> **"The bulk creation could not be started. Try again."가 표시됩니다**
>
> 배치가 시작되지 않았습니다. **Create N QR codes**를 다시 클릭하세요. 워크스페이스에서 다른 배치가 이미 실행 중이라면 완료될 때까지 기다리세요.

> **일부 코드에 Branded 또는 AI 디자인 대신 기본 디자인이 적용되었습니다**
>
> GetQR은 모든 Branded 또는 AI 디자인 코드가 안정적으로 스캔되는지 확인합니다. 확인할 수 없는 코드는 계속 스캔될 수 있도록 기본 디자인으로 대체됩니다.

## 다음 단계

> **[ZIP 다운로드](/ko/bulk/download-zip)**
>
> 모든 이미지를 하나의 파일로 받으세요.

> **[QR 코드 관리](/ko/getting-started/managing-qr-codes)**
>
> 생성 후 코드를 편집, 일시 중지 또는 삭제하세요.


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