上次更新时间： 2025年12月10日
在将数据导入HubSpot之前，请确认您的文件符合所需格式和技术限制。部分限制取决于订阅类型。了解支持的文件类型、属性值的结构与格式要求，以及特定时间段内可导入的行数和文件数量。
了解导入工具的工作原理，并使用示例文件或生成的范例文件准备数据。若文件准备就绪，请学习导入方法。
技术要求与限制
所有导入HubSpot的文件必须：- 采用.csv、.xlsx或.xls格式
- 仅包含一个工作表。
- 包含标题行，其中每列标题需与HubSpot属性对应。列标题排序顺序不影响导入。您可确认是否存在与 标题匹配的默认属性 ，或在导入前创建自定义属性。了解更多属性要求。
- 列数少于1000列。
- 若包含外语字符，请采用UTF-8编码。
- 若导入Excel文件：
- 数据量需低于Excel工作表及工作簿的最大容量限制。
- 导入日期和时间选择器属性时，单元格格式需设置为数字格式。
根据您的HubSpot订阅类型，导入工具存在额外技术限制。这些限制包括导入文件的大小和行数限制，以及每日可导入的文件数量和行数上限。
- 若使用 HubSpot 免费工具，您可：
- 导入文件大小上限为20MB。
- 每日最多完成50次导入。
- 每日导入行数上限为500,000行。若导入文件行数超过500,000行，则需多日才能完成处理。
- 若您的账户订阅了智能CRM或 入门版、专业版、企业版套餐，您可：
- 导入文件大小上限为512MB。
- 每日最多完成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中显示为Yes或勾选状态；设为False或No，则显示为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中创建关联标签。
- 若需将公司关联设为主要关联，请在该行关联标签列中填写值"Primary"。
- 若需为两条记录间的关系添加多个描述标签，可在单个单元格内输入多个关联标签值，用分号分隔（例如：经理; 账单联系人）。
- 若通过 多文件批量导入关联标签，需在同一文件中包含"关联标签"列及被关联对象的唯一标识符。
- 若导入配对标签：
- 跨对象关联时，关联标签列仅需填写其中一个标签。导入过程中系统将自动为对应对象分配正确标签。
- 对于同一对象关联：关联对象[唯一标识符]列 中的记录将接收导入过程中添加或文件标签列包含的标签；同一行中的另一记录将接收该配对标签的另一项。
示例文件
导入开始时，可生成包含所选对象及活动必备属性的示例文件。如需查看含更多属性的示例，请参阅本文档中的样例文件。
