> For the complete documentation index, see [llms.txt](https://newsleopard.gitbook.io/help-center/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://newsleopard.gitbook.io/help-center/features/lists/1.md).

# 如何大量匯入名單？

使用大量匯入可一次新增或更新大量會員資料。若你在匯入時遇到錯誤或資料無法寫入，本篇 FAQ 將協助你快速排查。

### 上傳 CSV（會導致整份檔案上傳失敗的錯誤）

大量匯入僅支援：

* `.csv` 格式
* 最大 **100 MB（付費）／ 1 MB（免費）**
* 編碼必須為 **UTF-8 或 BIG5**

以下任一狀況發生 → **整份檔案會直接上傳失敗**：

#### 1. 檔案格式錯誤：不是 CSV

請確認副檔名為 `.csv`。

#### 2. 檔案超過大小限制

* 付費帳號 → 100MB
* 免費帳號 → 1MB

#### 3. 檔案編碼錯誤（無法解析）

系統僅支援 UTF-8 或 BIG5。

#### 4. CSV 結構錯誤（欄位位置錯誤）

以下任一狀況皆無法解析：

* 第一行不是欄位名稱
* **第一欄不是 EMAIL**
* **第二欄不是 NAME**

![import-subscribers.jpg](https://4127314495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsvDTOR6r3x23iQ0fZfaN%2Fuploads%2Fgit-blob-b4e5f8ac6bb3c1b72032f355c3a66f4dd9d0336d%2Flists-1-import-subscribers.jpg?alt=media)

#### 5. 檔案內有重複欄位名稱

大小寫視為相同，例如：

```
email, name, phone, Phone
```

#### 6. 非預期錯誤

請重新上傳或聯絡客服。

***

### 欄位比對（最常見錯誤）

**匯入前必讀：CSV 中的欄位一定要先建立才可匯入。**

系統比對欄位名稱時「不分大小寫」：

* `phone`
* `Phone`
* `PHONE`

都視為同一欄位。匯入時會比對欄位名稱，**比對到即更新該欄資料**，欄位名稱為完全比對，所以「電話」和「電話號碼」會被視為不同欄位。

![import-subscribers-2-3.jpg](https://4127314495-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsvDTOR6r3x23iQ0fZfaN%2Fuploads%2Fgit-blob-40fbceb23c1c72e1d2779e582b6bed81c05bfff6%2Flists-1-import-subscribers-2-3.jpg?alt=media)

#### 無法匯入的欄位類型

**1. 尚未建立的欄位** → 必須先到後台「自訂欄位管理」新增。

**2. 不合法的欄位名稱** 包含特殊符號、全形字、過長欄位名、與系統保留字重複等。

**3. 停用欄位** 停用的自訂欄位 **不會匯入、不會更新**

#### 你可以選擇：

* **管理自訂欄位** → 新增缺少欄位後再匯入
* **略過欄位** → 僅匯入合法欄位

***

### 匯入中

系統會依序執行：

1. 解析
2. 驗證
3. 寫入資料

請勿關閉頁面。

***

### 匯入完成：成功 & 錯誤筆數

完成後會看到：

* 新增 / 更新成功筆數
* 失敗筆數
* 下載錯誤 CSV 報表

#### 常見「資料內容」錯誤

* EMAIL 格式錯誤
* EMAIL 在檔案中重複
* NAME 超出長度限制 (英文 200 個字母 / 中文 100 字)
* 欄位型別不符
* 日期格式錯誤

你可以下載錯誤 CSV 修正後再重新匯入。

***

### 加入群組（匯入前必填）

匯入名單前需選擇：

* 既有群組 或
* 建立新群組

***

### 清空欄位（重要）

#### 清空自訂欄位

→ 在 CSV 中「該欄位留空」即可清空。

#### 系統預設欄位無法清空

NAME、EMAIL 等欄位僅能覆蓋，不能清空。

***

### 小提醒

* 匯入不會自動建立新欄位
* 停用欄位無法匯入
* CSV 必須使用 UTF-8 / BIG5
* EMAIL 與 NAME 必須是前兩欄
* 不合法欄位會被跳過


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://newsleopard.gitbook.io/help-center/features/lists/1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.