# 導入集合項目

創建集合時，您可以手動添加集合項目，或者用CSV文件將它們直接導入到現有的集合。這允許從外部來源直接導入成百上千的數據項目到CMS中，並在導入這些內容時將CSV內容映射到參考字段。為了使大量數據的更新更容易一些，也可以透過CSV導入有選擇地更新現有的CMS項目。

本文會提到：

1. 如何將外部數據上傳到Webflow中
2. 如何配置字段和預覽項目
3. 如何導入映射的數據
4. 如何建造CSV文件
5. 如何使用支持的數據類型

## 如何將外部數據上傳到Webflow中

讓我們來了解一下如何將外部數據上傳到Webflow集合。在這個過程中，我們將涵蓋以下步驟。

1. 如何確定您可以導入的項目數量
2. 如何上傳CSV文件
3. 如何指定標題行
4. 如何選擇要導入的項目

### 如何確定可以導入的項目數量

使用免費的入門網站計劃，最多可以發布50個項目。若要導入超過50個項目，您需要為網站添加CMS或商業網站計劃，這兩個計劃分別允許多達2000個和10000個收藏項目。

### 如何上傳CSV文件

要將CSV文件上傳到Webflow中的指定集合。

1. 打開CMS面板
2. 選擇您的數據集
3. 點擊導入
4. 拖入您的CSV文件（或點擊瀏覽您的電腦）。

**注意**\
CSV文件的最大文件大小為4MB。

![](/files/e53TmWeEJnT33jIh1sMo)

![](/files/mSFmAAnJLyULrX3TA5L0)

### 如何指定標題行

在選擇CSV文件後，您會被提示要指定一個標題行。

通常，CSV的標題行包含定義每一列所含內容類型的列標籤。\
上傳CSV文件後，您會看到CSV的預覽，並能夠確認第一行是否為標題。選擇"是"或"我不確定"將第一行標記為標題，並將其排除在進口之外。選擇"否"則將該行納入導入範圍。

![](/files/PGOrYW5tBwtmAD59Kwz2)

無論在這階段做出什麽選擇，在下一步可以到第一項，勾選或取消勾選 "標題行"的選項。

![](/files/GYHxniG6xQ7xhkAj9kGI)

這個標題行的值將被設置為這個字段配置步驟的字段標籤。

### 如何選擇要導入的項目

選擇標題行之後，您會收到確認CSV文件已經完成處理。這個模式也會告訴您新上傳的CSV項目是否與收藏中的任何當前項目相匹配或不匹配。

**注意**\
如果您沒有選擇標題行，或者您不確定第一行是否為標題行，妳將直接進入字段配置，而沒有選擇更新匹配項目。從本質上講，Webflow默認為您創建新的項目，因為沒有標題行，就不可能映射到ID列或字段。\
如果您有匹配的項目，您可以選擇：

1. 更新匹配的項目：將收藏中的現有項目與CSV上傳的項目進行匹配
2. 將所有項目作為新項目導入：將CSV上傳中的匹配項目作為新項目加入收藏中。

![](/files/amXsmj1pXwXRkH3MVomg)

選擇更新匹配的項目是一個很好的方法，可以快速對收藏中的現有項目進行修改。例如在CSV文件中對選定項目的數據進行了更新，只需上傳更新後的項目，就可以快速地用新數據覆蓋CMS項目中的舊內容。

**注意**\
常規的CMS項目是根據"項目ID"字段來匹配的，該字段包含在從集合中導出的CSV文件中。(通過CSV導入更新項目不適用於電子商務項目。)也請記住，如果從備份中執行網站恢復，所有CMS集合和項目ID將被刷新。閱讀更多關於保存和恢復備份的訊息。

選擇更新匹配的項目或將所有項目作為新項目導入後，就可以開始配置CMS字段並將CSV數據映射到這些字段。

## 如何配置字段和預覽項目

在上傳CSV文件後，它的列將作為字段可用，您可以在導入的項目下的字段配置窗格中進行配置。如果指定，列標題將作為字段標籤出現。

**注意**\
如果CSV標題名稱與現有的字段名稱相匹配，它們將自動相互映射，並為您節省配置步驟。

![](/files/NxjcYRzUCnmY4vtiupbW)

輸入字段的值將從選定的行中提取。每行將轉化為一個集合項目。您可以在右邊的項目預覽窗格中預覽不同的項目。

### 如何配置字段

![](/files/PkrDinYU99t1aws21qxw)

在這一步您將配置字段，選擇哪些列需要映射，還可以為每一列創建新的字段。

![](/files/qb89NAIfQYWTDtHZhVgb)

### 不要映射字段

如果CSV裡有不想導入的列，從下拉選單中選擇不要導入。

![](/files/XMfiJ3pLjqsJoce7uZaA)

### 創建新字段

如果一個字段在集合中不存在，您可以創建一個，並將其映射到一列。

1. 選擇創建新字段
2. 從出現的下拉菜單中為這個新字段選擇字段類型。不支持列中內容的字段類型將不可用。
3. 添加新的字段標簽或保留建議的標籤。
4. 可選：添加幫助文本

您將有其他選項為不同的字段類型進行設置，新的選項字段將由該列的所有唯一值填充。對於一個新的開關字段，您可以指定哪個值映射到 "不"。

### 映射到現有字段

您可以將每一列映射到集合中的一個現有字段，列標籤旁邊的綠色指示燈表示該列已經被映射。

1. 選擇映射到現有字段
2. 從出現的下拉選單中選擇想把這個列映射到的字段。不支持某一列內容的字段將不可用，並且顯示灰色。

![](/files/CFFH0QHnhrmkxuMnPDO2)

對於開關字段，您可以指定哪個值映射到 "不"。或者，您可以用刷子把一個值映射到 "是"。

**注意**\
不能把一個列映射到已經在使用的現有字段。若需要將一個列映射到一個特定的字段類型，請創建一個新字段。

### 如何預覽項目

![](/files/ksiutA60ZgXbDubNMJoY)

在右邊的項目預覽窗格中預覽將被導入的每個項目的字段和值。\
使用預覽窗格頂部的左右箭頭按鈕在項目之間切換。\
點擊頂部欄中的顯示項目下拉選單，可以看到所有將被導入的項目的列表。在下拉式項目顯示選單打開的情況下，點擊任何項目的名稱來跳轉到其預覽。在搜索欄中鍵入文字來搜索特定的項目。

將鼠標懸停在左側面板中映射的或創建的字段上的任何地方，將突出顯示預覽項目中的相應字段。預覽項目隨著字段的配置而實時更新。

如果您需要編輯某個項目的字段的值，可以在配置字段之前進行，或者在下拉選單中選擇不要導入。

![](/files/SzVL2p9MNN9cZgrxvlrW)

您也可以選擇跳過導入特定項目到收藏中：

1. 在預覽窗格中找到不想導入的項目（例如使用箭頭、下拉選單或搜索欄）。
2. 打開"跳過導入"切換鍵

![](/files/bFVBr6SqxDnQb0ksrrap)

跳過的項目會在預覽窗格的頂部和顯示項目的下拉選單中以 "跳過導入"的圖標顯示。

### 有要求/驗證的字段

如果您的CSV列中的單元格被映射到一個必需的參考字段，而它是空的或不包含任何存在於該參考集合中的值，則您會收到一個警告說項目不存在。作為一個必填字段，該行的項目將被導入為草稿，而參考字段將被留空。

如果映射的參考字段不是必需的，並且該列中的單元格是空的，或者不包含任何存在於該參考集的值，那麽一旦導入，該行的項目將被設置為暫定發布，並且參考字段將被留空。

![](/files/tvtUOVSdioClyacQMUJF)

## 如何導入映射的數據

在您完全配置好CMS字段和CSV數據後，點擊右上方的導入按鈕，將數據添加到收藏中。

![](/files/BJGshWADC1VEfIgMTQEB)

等待，直到所有項目都被導入。

![](/files/Ioeo2qiHgGkaj5W1h4Fx)

如果部分或全部項目沒有被導入到收藏中，您會看到一個沒有被導入的項目列表，導入失敗的原因，以及一個可以下載詳細錯誤報告摘要的連結。

![](/files/WkkN1zQB4AtBzDLRsKD7)

**注意**\
您的網站將創建一個導入前的版本，您可以在網站設置的備份選項卡中恢復，以防導入時出現任何問題。

## 如何建造CSV文件

一般來說，從其他內容管理系統（如WordPress）導出的CSV文件的結構會與Webflow兼容。

但您可能想創建自己的CSV，並將這些數據導入一個集合。例如，您可以使用Google Sheets、MS Excel或Airtable來創建一個電子表格，列代表字段，行代表項目及其值。電子表格準備好之後，就可以把它保存為CSV文件。

**注意**\
在Excel中保存CSV文件時，一定要選擇CSV類型 "逗號分隔值"。其他CSV擴展名在上傳到Webflow時可能無法正確呈現。為了確保只有一列數據的CSV文件能夠正確導入，請在標題列標籤（如：姓名）後直接添加一個逗號。

## 如何使用支持的數據類型

當您上傳CSV文件時，Webflow CMS通常會很好地理解您的內容。但是，有些格式，如圖片、日期、數字和顏色的格式，可能無法識別。

關於格式化的一個很好的說明是，導出的Webflow CMS內容將被正確地格式化，以便導入。因此，使用導出的CSV文件將CMS內容從一個Webflow網站移到另一個網站上就可以了。

為了確保您的數據格式正確，並且可以映射到正確的字段類型，在創建您自己的數據庫電子表格時，請遵循以下準則。

* **名稱字段** - 任何少於256個字符的純文本字段都可以映射到這個字段上
* **Slug字段** - 任何少於256個字符的純文本字段都可以被映射到這個字段上\
  **注意**\
  如果沒有將CSV列映射到默認的名稱和lug字段，CMS將自動生成這些字段。
* **純文本字段** - 任何純文本值都可以映射到這個字段。
* **副文本字段** - 任何數值都可以映射到這個字段。要導入副文本，這個字段的值必須是HTML代碼。

  **注意**\
  在導入過程中，代碼會被 "清理"，以刪除副文本字段不支持的元素、類和屬性，所以記得在導入後檢查所有的副文本內容。
* **圖片字段** - 圖片應該作為直接的URL（以圖片文件擴展名結尾的鏈接）添加到CSV中。只有支持的圖像文件類型才會被導入到收藏中。
* **多圖像字段** - 與單個圖像一樣，圖像組應作為獨立的直接URL（以圖像文件擴展名結尾的鏈接）添加到CSV中。只有被支持的圖像文件類型才會被導入到收藏中。在一個單元格中的每一組圖像URLs應該用分號隔開。(例如，"<https://images.unsplash.com/bird1.jpeg>; <https://images.unsplash.com/bird2.jpeg>; <https://images.unsplash.com/bird3.jpeg>")
* **視頻字段** - 只有YouTube或Vimeo的URL可以被映射到視頻字段
* **連結字段** - 任何URL都可以被映射到連結字段上
* **電子郵件字段** - 只有電子郵件地址可以被映射到電子郵件字段中
* **電話字段** - 任何支持的電話號碼格式都可以映射到電話字段上
* **數字字段** - 只有數字可以被映射到這個字段。如果值包含字母，例如單位、符號或逗號，則無法將數字映射到數字字段。
* **日期/時間字段** - 任何支持的日期和時間格式都可以映射到這個字段。
* **交換字段** - 您可以將一個列映射到一個交換字段，當其單元格中只有兩個唯一的值時。例如，如果一列只有 "True"和 "False"兩個值，您可以將其導入為一個開關字段類型，並在映射階段指定哪個值表示 "Yes"。
* **顏色字段** - web顏色格式的任何值（顏色名稱、十六進制代碼、RGBA）都可以映射到這個字段。十六進制代碼必須在前面加上#，例如#4353ff。
* **選項字段** - 任何列都可以被映射到選項字段。這一列中的所有唯一值將成為這個字段的選項（最多有100個選項）。
* **文件字段** - 目前您不能將任何列映射到文件字段。您可以在導入所有數據後手動上傳文件。
* **參考字段** - 您可以映射格式為普通文本的內容--不需要特殊格式。
* **多參考字段** - 您可以映射其單元格內由分號分隔的內容，就像多圖像字段內容一樣。


---

# Agent Instructions: 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:

```
GET https://docs.tenten.co/docs-webflow/webflow-101/6-cms/dao-ru-ji-he-xiang-mu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.