카탈로그 관리하기

이 페이지는 이미 만든 카탈로그를 최신 상태로 유지하는 방법을 다룹니다. 신상품을 붙이고, 가격·재고를 갱신하고, 단종 상품을 정리하고, 필드를 늘리거나 카탈로그 자체를 삭제하는 일이 여기에 해당합니다.

카탈로그를 처음 만드는 방법은 카탈로그 만들기, 메시지에서 쓰는 방법은 메시지에서 카탈로그 사용하기를 참고하세요.

카탈로그 상세화면

아이템 편집하기

아이템은 하나씩 고칠 수도 있고 CSV로 한 번에 바꿀 수도 있습니다. 몇 개만 급하게 고칠 때는 직접 수정, 그 외에는 CSV가 빠르고 실수도 적습니다. 아이템 탭 > 아이템 편집 버튼에서 시작합니다.

직접 추가하기

• 아이템 추가: 아이템 편집 > 직접 추가하기 → 필드 값 입력 → 저장하기. * id는 필수이며 중복될 수 없습니다.

목록에서 직접 수정하기

• 목록에서 바꿀 값을 더블 클릭하여 값을 직접 수정할 수 있습니다.

• 수정 후 상단의 [저장하기]를 눌러 변경사항을 저장합니다. * id는 수정할 수 없습니다.

목록에서 직접 수정하기

• 아이템 삭제: 목록 왼쪽 체크박스로 선택한 뒤 삭제합니다.

CSV 업로드

아이템 편집 > CSV 업로드를 누르면 먼저 업로드 방식을 고릅니다. CSV의 id가 카탈로그에 이미 있는지에 따라 동작이 달라지므로, 방식을 잘못 고르면 의도하지 않은 결과가 나옵니다.

아이템 CSV를 올릴 때는 미리 정의한 필드가 CSV 헤더에 모두 포함되어야 합니다.

아이템 업로드는 백그라운드로 동작합니다. 화면을 닫아도 계속 진행되며, 완료되면 카탈로그 상세에서 결과를 확인할 수 있습니다. 한 카탈로그에 CSV 업로드는 한 번에 하나씩만 진행됩니다.

동일한 id를 가진 행이 CSV에 있다면 아래처럼 처리됩니다.

• 새 아이템만 추가: 더 먼저 나온 행의 값이 반영됩니다.

• 기존 아이템만 수정: 더 나중에 나온 행의 값이 반영됩니다.

• 추가하고 수정: 더 나중에 나온 행의 값이 반영됩니다.

CSV 파일 준비 체크리스트

업로드 전에 파일이 아래 조건을 모두 만족하는지 확인하세요. 하나라도 빠지면 업로드가 실패하거나 값이 비어서 올라갑니다.

확인 항목	요건
헤더	첫 행은 필드 이름입니다. 이 이름이 그대로 카탈로그의 필드명이 됩니다. 필드명은 영문·숫자·-·_만 사용 가능합니다.
id 컬럼	반드시 있어야 합니다. 이름은 정확히 id여야 하며, 컬럼 순서는 상관없습니다.
id 값	중복 없음 · 최대 300자 · 영문·숫자·-·_만 사용 가능합니다.
컬럼 수	최대 50개
값 형식	각 컬럼의 값이 타입(string·number·boolean·time)에 맞아야 합니다. 숫자 컬럼에는 단위나 콤마가 없어야 하고, 날짜 컬럼은 시간대 오프셋이 있는 ISO 8601 형식이어야 합니다.
미정의 값	빈 셀은 허용됩니다. NULL, null, - 같은 값은 빈 값이 아니라 문자로 저장되니 비워 두세요.
파일 형식	CSV, UTF-8 인코딩
파일 크기	최대 500MB
아이템 수	최대 100만 개 (id 기준)

카탈로그 데이터 유형

카탈로그는 데이터를 효과적으로 구성하고 체계화하는 데 도움이 되는 다양한 데이터 유형을 지원합니다.

데이터 유형	형식	설명	예시
String	텍스트	자유로운 텍스트. 한글·특수문자·공백 허용 (최대 750자)	"Hello World"
Number	정수 또는 소수	계산할 수 있는 숫자. 정수·소수·부호 허용 (정수부 20자리 · 소수부 10자리)	42000 또는 19.99
Boolean	true 또는 false	둘 중 하나인 값. true/false(대소문자 무관) 또는 1/0	true
Time	ISO 8601	타임존이 지정된, 올바른 ISO 8601 형식	"2026-09-15T09:00:00Z"

필드 관리

필드는 필드 탭에서 관리합니다. 추가하고 설명을 고치고 삭제할 수 있지만, 한 번 만든 필드의 이름과 타입은 바꿀 수 없습니다. 메시지가 필드명으로 값을 찾기 때문입니다.

필드 추가 입력창

• 필드 추가: 언제든 가능합니다. 단, 필드를 추가하면 이후 올리는 아이템 CSV 헤더에도 그 필드가 있어야 합니다.

  • 새 필드는 기존 아이템에서 모두 빈 값으로 시작합니다. id와 새 필드 컬럼만 담은 CSV를 기존 아이템만 수정으로 올려 값을 한 번에 채우세요.

• 필드 삭제: 가능하지만, 아이템이 있는 상태에서 필드를 삭제하면 그 필드에 들어 있던 값이 모두 사라지고 되돌릴 수 없습니다. 그 필드를 참조하는 메시지가 있는지 먼저 확인하세요.

• 필드 타입 변경: 불가합니다. 필드를 삭제한 뒤 다시 만들어야 합니다.

발송 중인 메시지가 사용 중인 필드는 삭제하지 마세요.

사라진 필드를 참조하는 메시지는 그 자리가 비어서 나갑니다. 삭제 전에 이 필드를 쓰는 메시지부터 정리하세요.

카탈로그 삭제하기

카탈로그 상세 화면 오른쪽 위의 휴지통 아이콘을 누르면 삭제 확인 창이 뜹니다. 카탈로그와 그 안의 아이템이 모두 삭제되며, 운영 환경과 개발 환경에서 함께 사라집니다. 되돌릴 수 없습니다.