上次更新時間： 2025年12月10日
在將資料匯入 HubSpot 之前，請確認您的檔案符合所需格式與技術限制。部分限制取決於訂閱方案。請了解支援的檔案類型、屬性值的結構與格式規範，以及特定期間內可匯入的行數與檔案數量。
請檢視匯入工具的運作方式，並使用範例檔案或系統生成的範例檔案來準備您的資料。若檔案已準備就緒，請學習如何進行匯入。
技術要求與限制
所有匯入 HubSpot 的檔案必須：- 為 .csv、.xlsx 或 .xls 格式檔案
- 僅含單一工作表。
- 包含標題列，其中各欄位標題須對應 HubSpot 屬性。欄位標題順序可自由排列，不影響匯入結果。您可確認是否已有預設屬性與 標題匹配 ，或於匯入前建立自訂屬性。深入瞭解屬性要求。
- 列數需少於 1000 列。
- 若包含外語字元，請採用 UTF-8 編碼。
- 若您正在匯入 Excel 檔案：
- 資料量須低於 Excel工作表與工作簿的最大限制。
- 匯入日期與時間選擇器屬性時，相關儲存格須採用數字格式。
根據您的HubSpot 訂閱方案，匯入工具另有技術限制。這些限制包含匯入檔案的大小與行數上限，以及每日可匯入的檔案數量與行數。
- 若使用 HubSpot 免費工具，您可：
- 每次匯入檔案大小上限為 20MB。
- 每日最多完成 50 次匯入作業。
- 每日最多匯入500,000行資料。若匯入檔案行數超過500,000行，將需數日才能完成處理。
- 若您的帳戶擁有Smart CRM或入門版、專業版、企業版訂閱方案，您可：
- 匯入檔案大小上限為512 MB。
- 每日完成最多 500 次匯入作業。
- 每日最多匯入 10,000,000 筆資料，每筆檔案上限為 1,048,576 筆。若透過匯入 API 操作，每日可處理高達 80,000,000 筆資料。
上述限制適用於連續 24 小時週期，不會在特定時間重置。深入了解您的HubSpot 訂閱方案及其限制。
格式化數值
您可在匯入檔案的每行中為屬性欄位新增數值。數值格式取決於屬性欄位類型及匯入目標。
依據屬性欄位類型格式化值
不同屬性欄位類型有特定格式要求：
| 欄位類型 | 格式要求 |
| 日期選擇器 日期與時間選擇器 |
月份可採用數字、三字母縮寫或完整名稱（10、OCT、Oct、OCTOBER、October）；年份可為兩位數或四位數（2023、23）；分隔符號可為斜線、連字號或句點（10/28/2023、10-28-2023、 10.28.2023）。 有效日期格式為日-月-年（例如 28/10/2023）、月-日-年（例如 10-28-23）或年-月-日（例如 2023.OCT.28）。 若您已設定驗證規則，匯入的值必須符合規則，否則將無法匯入。 |
| 日期與時間選擇器 |
所有 檔案類型皆可 輸入 hh:mm 格式時間戳記（例如 28/10/2020 14:30）， CSV 檔案或採用文字數字格式的 Excel 檔案則可輸入毫秒級 UNIX 時間戳記。若未指定時間戳記，系統將預設為午夜零時。 |
| 持續時間 |
針對包含持續時間的屬性（例如通話時長屬性），數值必須採用毫秒級UNIX時間戳格式。瞭解如何格式化時間戳值以及如何將日期轉換為UNIX格式。 |
| 枚舉 |
匯入檔案中的值必須與屬性定義選項的標籤或內部值完全匹配。對於 HubSpot 預設枚舉屬性（例如生命週期階段、產業），值必須與內部值或英文標籤完全匹配。 |
| 檔案 |
|
| 多重核取方塊 |
匯入多個值時，請在每個值之間添加分號且不留空格（value 1;value 2）。此類屬性選項必須在匯入前預先建立。 若需新增或追加值，請在首個值前添加分號（;值 3;值 4）。此操作將追加值而非覆寫現有屬性值。 深入了解匯入多重核取方塊值。 |
| 數字 |
依據建立的數字屬性類型格式化數值：
|
| 單選核取方塊 |
為單選核取方塊欄位建立欄位，並將每行值設定為True或Yes以在 HubSpot 顯示為「是」或「已勾選」，或設定為False或No以顯示為「否」或「未勾選」。 |
| 條款屬性 |
條款項目屬性應採用 ISO-8601 週期格式PnYnMnD 或 PnW 填寫。例如年度條款應填寫 P12M 或 P24M。若留空，系統將設定預設條款。 |
| 文字 |
若您已設定 驗證規則，則匯入值必須符合規則，否則將無法匯入。 |
| 使用者（擁有者） |
要在匯入過程中為記錄或活動指派擁有者：
|
附加聯絡人電子郵件或公司網域
若匯入的聯絡人含多個電子郵件地址，請新增「附加電子郵件地址」欄位填入次要郵件。若匯入的公司含多個網域名稱，請新增「附加網域 」欄位 填入次要網域。單一儲存格內若需列出多個郵件或網域，請以分號分隔值（例如：email@email.com;emailtwo@email.com）。
若您是為建立聯絡人或公司而匯入資料，請注意：新聯絡人的電子郵件欄位，以及新公司的公司網域名稱欄位， 皆不可 設定為 其他記錄中已存在的附加電子郵件/網域。
空白儲存格
匯入工具會忽略試算表中的空白儲存格，因此匯入新屬性資料時，請將無屬性值的記錄儲存格留空。若現有記錄在 HubSpot 中已有屬性值，空白儲存格將不會清除現有屬性值。若需批次清除現有屬性值 ， 可手動編輯 數值或使用「 編輯記錄」工作流程 動作。交易協作者
若需透過匯入新增交易協作者，請包含「交易協作者」標題欄位。每個儲存格必須包含兩位以上使用者，以分號分隔（例如：user1@example.com;user2@example.com）。產品期限與計費週期
若匯入「期限」屬性值，可於「期限」欄位採用以下格式：以月數表示（例如10代表 10 個月）、PXM 格式（ X 為月數， 例如P6M 代表 6 個月）或PXY 格式（X 為年數，例如P1Y 代表 1 年）。
若匯入「計費週期」屬性值，當產品採用定期定額計費時，請使用monthly、annually 或quarterly。若產品為一次性計費，則留空該儲存格。
必填屬性
根據匯入的物件或活動類型，下列屬性為建立記錄之必要欄位，且必須包含於檔案的欄位標題中。 若更新記錄，必須包含唯一識別碼（例如記錄ID、電子郵件、公司網域名稱）。
雖非必要，您可為每個物件匯入額外屬性，包含自訂與預設屬性。請參閱聯絡人、公司、交易、票證、通話、電子郵件、會議、筆記 及任務的預設屬性。您亦可於屬性設定中檢視所有屬性及其值。
- 聯絡人：至少包含以下任一欄位：名字、姓氏或 電子郵件。
- 公司：至少包含 名稱或公司網域名稱其中一項。
請注意： 公司網域名稱屬性僅接受頂級網域名稱（例如 .com、.edu）。若值包含頂級網域後的字串（例如 .edu/home），系統將於匯入時自動移除該部分。
- 交易：若建立新交易，需包含交易名稱、銷售管道及 交易階段。
- 工單：若 建立新工單，需包含工單名稱、流程與 工單狀態 。
- 預約：預約開始時間。預約開始時間應以日期時間屬性格式填寫。
- 課程：課程名稱。
- 房源：名稱。
- 服務項目：名稱、銷售管道及銷售階段。
- 產品：若 更新產品，請提供記錄ID或 SKU。
- 訂單：名稱、銷售管道及銷售階段。
- 購物車：名稱。
- 明細項目： 名稱、數量、價格，以及關聯交易的記錄ID或 交易名稱。 若 同時將明細項目關聯至產品，請 包含產品ID， 該ID將於匯入時作為明細項目屬性進行映射。
請注意：當您匯入與交易關聯的明細項目時，匯入程序不會更新交易金額。若需更新關聯交易金額，您可手動編輯明細項目，或在 HubSpot 中將明細項目與交易建立關聯。
- 通話記錄： 通話備註。導入新通話時，建議同時包含 活動日期。
- 電子郵件： 郵件正文與 郵件方向。
- 會議：會議描述、會議開始時間與會議結束時間。導入新會議時，亦建議包含 活動日期。開始時間、結束時間及活動日期值應格式化為日期時間屬性。
- 備註：備註內容。
- 任務：任務標題與截止日期。截止日期 應格式化為日期時間屬性。
請注意：雖然非必要，但建議在匯入新活動時包含活動日期，以指定活動發生的時間。若未包含此屬性，系統將自動將活動日期值設為匯入當下的時間。
更新現有記錄或避免重複
記錄之
要求
為更新現有記錄並避免重複記錄，您的檔案必須為每個物件包含唯一識別符屬性。所有物件皆可 透過匯出現有 記錄並使用 記錄 ID 作為唯一識別符，或 採用 需具備唯一值的自訂屬性。 聯絡人可另採用電子郵件地址，企業則可採用企業網域名稱 。
若您匯入多個物件且包含記錄 ID，建議區分檔案欄位標題以對應正確物件（例如：一欄命名為「記錄 ID - 聯絡人」，另一欄命名為「記錄 ID - 公司」）。
請注意：若檔案包含電子郵件或公司網域名稱欄位，將 產生以下行為：
- 若您使用自訂唯一值屬性來消除聯絡人重複，電子郵件屬性仍需保持唯一值。
- 若使用自訂唯一值屬性進行企業重複資料清除，則公司網域名稱屬性無需唯一值。這意味著您可匯入重複的公司網域。若不希望出現相同網域的多間企業，請於匯入前從檔案中移除重複網域，或改用公司網域名稱作為唯一識別碼。
- 對於已在 HubSpot 登錄備用電子郵件的現有聯絡人，可使用備用電子郵件作為唯一識別碼 。若使用備用電子郵件且 檔案未包含「記錄ID」欄位，備用電子郵件將不會取代主要電子郵件。但若檔案同時包含備用電子郵件與記錄 ID 欄位，則備用電子郵件將取代主要電子郵件。
關聯記錄的要求
在單一檔案中匯入關聯
單一檔案中，每行可關聯兩筆或以上記錄。請在同一行包含關聯記錄和/或活動的資訊，並為每個物件加入唯一識別碼。若要將單一記錄關聯至多個活動或另一物件的記錄，請為每個欲關聯的記錄在多行中加入該記錄的唯一識別碼。
舉例說明：Luke Danes 同時擔任 Luke's Diner 經理與 The Dragonfly Inn 承包商。若要將其關聯至兩家公司，需為 Luke Danes 建立兩行資料，每行包含電子郵件（或記錄 ID）與公司網域名稱（或記錄 ID）欄位。
請注意：若未包含 唯一識別碼（如電子郵件、公司網域名稱、 記錄ID），匯入時將產生重複記錄而非建立關聯。
若需匯入相同物件關聯，則有額外要求。
分兩份檔案匯入關聯
欲將兩份檔案中不同物件的記錄關聯，請使用共同欄位串接各檔案記錄。可參考範例檔案獲取更多匯入與關聯記錄的協助。
相同物件關聯
您可透過單一檔案批次關聯相同物件的記錄。匯入過程中需勾選核取方塊以啟用相同物件關聯功能
。 設定檔案時，請將關聯記錄資訊置於同一行，並為每筆記錄包含唯一識別碼。以下為相同物件匯入的特定要求：
- 在匯入前，記錄對中的至少一項記錄必須已存在於 HubSpot 中。例如：您可匯入新聯絡人並與現有聯絡人關聯，但無法同時建立並關聯兩個新聯絡人。
- 關聯現有聯絡人/公司時，僅能使用主要電子郵件/公司網域作為唯一識別碼，次要電子郵件或網域不被支援。
- 若需將多個記錄關聯至單一記錄，請於同一儲存格內以分號分隔各記錄的唯一識別碼值（例如：luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com）。
以下範例檔案中，Rory 和 Jackson 是透過電子郵件值作為唯一識別碼，以專屬標籤關聯至現有聯絡人。Sookie 則是現有聯絡人，同時關聯至兩個具相同標籤的現有聯絡人。首行關聯標籤屬於標籤對組合，表示匯入完成後，關聯記錄將標示為「Parent」（父），而 Rory則標示為配對標籤「Child」（子）。
父/子關聯關係
若需透過匯入建立子公司與母公司關聯，請參閱匯入子公司相關說明。
自訂關聯標籤
需要訂閱 使用自訂關聯標籤需具備專業版或 企業版訂閱資格。
若需匯入關聯標籤，請包含「 關聯標籤」欄位。此欄位僅在您需要添加標籤描述關聯時才需添加。若無需標註關聯，則此欄位非必要。
- 您必須在匯入前於 HubSpot 中建立關聯標籤。
- 若要將公司關聯設為主要關聯，請在該行的關聯標籤欄位中填入值「主要」。
- 若需設定多個標籤描述兩筆記錄間的關係，可在單一儲存格內輸入多個關聯標籤值，並以分號分隔（例如：經理; 帳務聯絡人）。
- 若透過 多檔案匯入方式導入關聯標籤，需在同一檔案中包含關聯標籤欄位及所關聯物件的唯一識別碼。
- 若您正在匯入配對標籤：
- 跨物件關聯時，僅需在關聯標籤欄位填入其中一個標籤。系統將於匯入過程中自動將標籤分配至正確物件。
- 針對同一物件關聯：關聯[唯一識別碼]欄位的記錄 將接收匯入過程中新增或文件標籤欄位包含的標籤；同列另一記錄則接收配對標籤中的另一標籤。
範例檔案
匯入流程開始時，可針對選取的物件與活動生成具備必要屬性的範例檔案。若需檢視含進階屬性的更多範例，請參閱附有範例檔案的這篇文章。
