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

# 참가자 추가와 가져오기

> 참가자를 한 명씩 추가하거나 CSV·Excel 명단을 가져오기 창에서 올리고 열을 연결해 검토한 뒤 결과를 확인하는 방법입니다.

참가자는 한 명씩 추가하거나 파일로 한꺼번에 가져옵니다. 두 방법 모두 게시 전후에 쓸 수 있습니다. 이렇게 등록한 참가자는 자동으로 승인되어 초대를 보내기 전까지 명단에 **미초대** 상태로 보입니다.

<Note>
  두 방법 모두 참가 유형이 하나 이상 있어야 합니다. 가져오기 파일은 CSV 또는
  Excel이고 4MB 이하여야 하며 Excel은 첫 번째 시트만 읽습니다. 행사가 끝나면
  추가와 가져오기가 모두 막힙니다.
</Note>

<Steps>
  <Step title="한 명 추가하기">
    **참가자** 메뉴에서 **참가자 추가** 버튼을 누르세요. **참가 유형** 항목을 고르고 **이름**·**이메일** 칸을 채운 뒤 **추가** 버튼을 누릅니다. 이메일 주소는 한 행사에 한 번만 등록됩니다.

    게시된 행사라면 바로 **초대를 보낼까요?** 확인창이 열려 그 자리에서 초대할 수 있습니다. 나중에 보내려면 **취소** 버튼을 누르세요.
  </Step>

  <Step title="파일 올리기">
    **가져오기** 버튼을 누르면 **참가자 가져오기** 창이 열립니다. **템플릿 다운로드** 링크로 받은 CSV에는 행사의 프로필 필드까지 열로 들어 있습니다. 파일을 끌어다 놓거나 **파일 선택** 버튼으로 고른 뒤 **다음** 버튼을 누르세요.
  </Step>

  <Step title="열 연결하기">
    표의 **파일 열** 하나마다 **연결 필드** 값이 머리글에 맞춰 미리 제안됩니다. **이름**·**이메일** 필드는 꼭 연결해야 하고 필요 없는 열은 **가져오지 않음** 항목으로 두세요.

    **참가 유형** 필드에 연결한 열이 없으면 모든 행에 적용할 **기본 참가 유형** 값을 골라야 합니다. 필수 필드가 비어 있거나 두 열이 같은 필드를 가리키는 동안에는 **다음** 버튼이 비활성입니다.
  </Step>

  <Step title="검토하기">
    **전체 행**·**신규**·**업데이트**·**경고**·**오류** 수가 보이고 **문제 있는 행** 표에 행별 사유가 나옵니다. 오류가 있는 행은 제외되고 경고가 있는 행은 가져오되 명단에 **정정 필요** 표시가 붙을 수 있습니다.

    **기존 참가자** 항목은 이미 명단에 있는 사람을 어떻게 할지 정합니다. **건너뛰기** 항목은 그대로 두고 **정보 업데이트** 항목은 파일 값으로 참가 유형과 답변을 덮어씁니다. 기존 참가자는 이메일 주소로 찾습니다. **가져오기 시작** 버튼을 누르세요.
  </Step>

  <Step title="완료 기다리기">
    진행률이 보이는 동안 창을 닫아도 가져오기는 계속되고 명단이 자동으로 갱신됩니다.

    결과는 **가져오기 완료**, **일부 행을 가져오지 못했습니다**, **가져오기 실패** 중 하나이며 신규·업데이트·건너뜀 수가 함께 나옵니다. 실패한 행은 **실패한 행 다운로드** 링크로 받고 **완료** 버튼으로 창을 닫습니다.
  </Step>
</Steps>

## 결과 확인

새로 들어온 참가자는 명단에 **미초대** 상태로 보입니다. **가져오기** 버튼 옆 시계 아이콘은 **가져오기 이력** 시트를 열며 가져오기마다 **진행 중**·**완료**·**일부 실패**·**실패** 상태와 실패한 행 다운로드 링크가 남습니다.

## 다음 단계

* 추가한 사람에게 [초대를 보내세요](/ko/host/participants/invitations).
* 가져오기 전에 [프로필 필드](/ko/host/settings/profile-fields)를 만들어 두면 템플릿에 그 열이 함께 들어갑니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="CSV 또는 Excel(.xlsx) 파일만 지원합니다">
    파일을 .csv나 .xlsx로 저장하세요. 4MB를 넘는 파일도 거부되므로 명단을 나눠서
    여러 번 가져옵니다. Excel 파일은 첫 번째 시트만 읽으니 데이터를 첫 시트로
    옮기세요.
  </Accordion>

  <Accordion title="연결되지 않은 필수 필드">
    **이름** 또는 **이메일** 열이 없거나 **가져오지 않음** 상태입니다. 알아보지
    못한 머리글은 모두 **가져오지 않음** 상태로 시작하므로 연결 표를 한 행씩
    확인하세요. 템플릿으로 시작하면 이 문제가 생기지 않습니다.
  </Accordion>

  <Accordion title="업데이트한 참가자가 승인 상태가 아닙니다">
    **정보 업데이트** 항목은 프로필 데이터만 바꿉니다. **승인 대기**·**반려됨**
    상태였던 사람은 그대로 남고 초대 대상에서 빠지므로 참가시킬 사람이라면
    명단에서 승인하세요.
  </Accordion>

  <Accordion title="가져오기 실패">
    파일 전체를 처리하지 못했습니다. 다시 시도하고 계속 실패하면 결과 화면에
    적힌 문의 주소로 알려 주세요.
  </Accordion>
</AccordionGroup>


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