上次更新时间： 2026年8月6日
在将数据导入 HubSpot 之前，请确认您的文件符合要求的格式和技术限制。部分限制取决于订阅类型。请了解支持哪些文件类型、如何组织和格式化属性值，以及在指定时间段内可以导入多少行和多少个文件。
导入前，请阅读《导入入门》文章。
技术要求和限制
导入到
HubSpot 的所有文件必须：- 为 .csv、.xlsx 或 .xls 文件。
- 仅包含一个工作表。
- 包含一行标题行，其中每列标题均对应 HubSpot 中的一个属性。列标题的排列顺序不限，不会影响导入。您可以在导入前确认是否已有与 标题匹配的默认属性 ，或创建自定义属性。了解有关属性要求的更多信息。
- 列数少于 1,000 列。
- 如果文件包含外语字符，请使用 UTF-8 编码。
- 如果您要导入 Excel 文件：
- 数据量须在 Excel工作表和工作簿的最大限制范围内。
- 导入日期和时间选择器属性时，单元格格式应为“数字”。
根据您的HubSpot 订阅类型，导入工具还受其他技术限制的约束。这些限制包括导入文件的大小和行数限制，以及每天可导入的文件数量和行数。
- 如果您使用的是 HubSpot 的免费工具，您可以：
- 导入大小不超过 20MB 的文件。
- 每天最多可完成 50 次导入。
- 每天最多导入 500,000 行。包含超过 500,000 行的文件，将需要数天才能完成导入。
- 最多可同时启动 3 次导入操作。其中最多 2 次导入的行数可超过 10,000 行。如果您同时启动 4 次或更多导入操作，这些操作将被排入队列。
- 如果您的账户拥有Smart CRM或Starter、Professional 或Enterprise订阅，您可以：
- 导入大小不超过 512 MB 的文件。
- 每天最多可完成 500 次导入。
- 每天最多导入 10,000,000 行，每个文件上限为 1,048,576 行。如果您通过导入 API 进行导入，每天最多可导入 80,000,000 行。
- 最多可同时启动 3 个导入任务。其中最多 2 个导入任务的行数可超过 10,000 行。如果您同时启动 4 个或更多导入任务，这些任务将被排入队列。
这些限制适用于滚动 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）。 如果您已设置验证规则，导入的值必须符合这些规则，否则将无法导入。 |
| 日期和时间选择器 |
在 所有文件类型中， 时间戳均可采用 相对于您账户时区的时区偏移量可以以 |
| 时长 |
对于包含持续时间的属性（例如“通话时长”属性），其值必须以毫秒为单位的 UNIX 时间戳格式呈现。了解有关如何格式化时间戳值以及如何将日期转换为UNIX 格式的更多信息。 |
| 枚举 |
导入文件中的值必须与属性已定义选项的标签或内部值相匹配。对于 HubSpot 默认枚举属性（例如“生命周期阶段”、“行业”），值必须与内部值或英文标签相匹配。 |
| 文件 |
|
| 多个复选框 |
要导入多个值，请在每个值之间添加分号且不留空格（值 1;值 2）。这些属性选项必须在导入前创建。 若要添加或追加值，请在第一个值前添加分号（;值 3;值 4）。这样会追加该值，而非覆盖现有的属性值。 了解有关导入多个复选框值的更多信息。 |
| 数字 |
根据创建的数字属性类型设置值格式：
|
| 单选复选框 |
为单选复选框字段创建一列，并将每行值设置为“True”或“Yes”，以便在 HubSpot 中显示为“是”或勾选状态；或设置为“False”或“No”，以便在 HubSpot 中显示为“否”或未勾选状态。 |
| 期限属性 |
行项目属性“期限”应采用 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 年）。
若导入“计费频率”属性值，当产品采用周期性定价模式时，请使用“每月”、“每年”或“每季度”
；
若产品采用一次性定价，请将单元格留空。
包含必填属性
根据您要导入的对象或活动类型，以下属性是创建记录的必填项，必须作为列标题包含在文件中。 若要更新记录，必须包含唯一标识符（例如：记录 ID、电子邮件、公司域名）。
虽然并非必需，但您可以为每个对象导入其他属性，包括自定义属性和默认属性。请参考联系人、公司、商机、工单、通话、电子邮件、会议、笔记 和任务的默认属性。您还可以在属性设置中查看所有属性及其值。
- 联系人： 电子邮件。您还可以包含“名字”和“姓氏”作为基本识别信息。
- 公司：至少包含 “名称”或“公司域名”其中之一。
请注意： 公司域名属性仅接受顶级域名（例如 .com、.edu）作为值。导入时，顶级域名后带有字符串的值（例如 .edu/home）将被自动删除。
- 商机：如果您正在创建新商机，则需提供“商机名称”、“销售管道”和“商机阶段”。“销售管道”和“商机阶段”必须与您账户中的现有选项匹配，且“商机阶段”必须是该销售管道中的有效阶段。
- 工单：如果您 正在创建新工单，请填写“工单名称”、“销售管道”和“工单状态”。
- 预约：预约开始时间。预约开始时间应以日期时间属性格式填写。
- 课程：课程名称。
- 房源：名称。
- 服务：名称、销售管道和销售管道阶段。
- 产品：如果您 正在更新产品，请提供记录 ID或SKU。
- 订单：名称、销售漏斗和销售漏斗阶段。
- 购物车：名称。
- 明细行： 名称、数量、价格以及关联交易的记录 ID 或 交易名称。 如果您 还将明细行与产品相关联 ，请 包含该产品的 产品 ID ，该 ID 将在导入过程中映射为明细行属性。
请注意：在将明细行与交易一起导入时，导入操作不会更新交易金额。若要更新关联交易的金额，您可以手动编辑明细行，或在 HubSpot 中将明细行与交易关联。
- 通话： 通话备注。导入新通话时，还建议包含 活动日期。
- 电子邮件： 邮件正文和 邮件发送方向。
- 会议：会议描述、会议开始时间和会议结束时间。导入新会议时，还建议包含 活动日期。开始时间、结束时间和活动日期值应格式化为日期时间属性。
- 备注：备注正文。
- 任务：任务标题和截止日期。 截止日期应格式化为日期时间属性。
请注意：虽然并非必需，但在导入新活动时，建议包含“活动日期”以指定活动发生的日期和时间。如果您未包含此属性，则“活动日期”的值将自动设置为导入时的日期和时间。
更新
现有记录或
避免重复记录
的要求
要更新现有记录并避免重复记录，您的文件必须为每个对象包含一个唯一标识符属性。对于所有对象，您可以 导出现有记录 并使用 “记录 ID”作为唯一标识符，或使用要求唯一值的自定义属性。 对于联系人，您还可以使用“电子邮件 ” 。对于公司，您还可以使用“公司域名”。
如果您要导入多个对象且包含“记录 ID”，建议区分文件列标题，以便将 ID 与正确的对象匹配（例如，一列命名为“记录 ID - 联系人”，另一列命名为“记录 ID - 公司”）。
请注意：如果您的文件中包含“电子邮件”或“公司域名 ”，则适用以下行为：
- 如果您使用自定义唯一值属性来去除联系人重复项，则“电子邮件”属性仍需唯一值。
- 如果您使用自定义唯一值属性对公司进行去重，则“公司域名”属性无需唯一值。这意味着您可以导入重复的公司域名。如果您不希望存在多个具有相同域名的公司，应在导入前从文件中删除重复的域名，或者改用“公司域名”作为唯一标识符。
- 对于在 HubSpot 中已列出备用电子邮件地址的现有联系人，您可以使用备用电子邮件作为唯一标识符 。如果您使用备用电子邮件，且未 在文件中包含“记录ID”列，则备用电子邮件不会替换主电子邮件。但是，如果您在文件中同时包含“备用电子邮件”和“记录 ID”两列，备用电子邮件将替换主电子邮件。
关联记录的要求
在一个文件中导入关联关系
在一个文件中，您可以每行关联两个或多个记录。请在同一行中包含相关记录和/或活动的信息，并为每个对象提供唯一标识符。若要将一个记录与多个活动或另一个对象的多个记录关联，请针对您希望关联的每个记录，在多行中分别包含该记录的唯一标识符。
例如，卢克·丹尼斯（Luke Danes）是“卢克餐厅”（Luke's Diner）的经理，但同时也是“蜻蜓旅馆”（The Dragonfly Inn）的承包商。要将他与这两家公司关联，您需要为卢克·丹尼斯添加两行数据，每行分别包含“电子邮件”（或“记录 ID”）和“公司域名”（或“记录 ID”）列，对应两家公司。
请注意：如果您未 包含唯一标识符（例如“电子邮件”、“公司域名 ”或“记录ID”），导入操作将创建重复记录，而非将各记录关联到同一条记录。
如果您要导入同一对象的关联关系，则有额外的要求。
通过两个文件导入关联关系
要关联两个文件中两个对象的记录，请使用一个共同的列来连接每个文件中的记录。您可以参考示例文件，以获取有关导入和关联记录的更多帮助。
同一对象关联
您可以导入一个文件，批量关联同一对象的记录。在导入过程中，您需要勾选复选框以包含同一对象关联。
设置文件时，请在同一行中包含关联记录的相关信息，并为每条记录提供唯一标识符。以下附加要求专门针对同一对象导入：
- 在导入前，记录对中至少有一条记录必须已存在于 HubSpot 中。例如，您可以导入一个新联系人并将其与现有联系人关联，但不能通过导入来创建并关联两个新联系人。
- 关联现有联系人/公司时，您只能使用主电子邮件地址/公司域名作为唯一标识符。不支持使用备用电子邮件地址或域名。
- 如果您要将多个记录关联到一个记录，请在同一单元格中用分号分隔各记录的唯一标识符值（例如：luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com）。
在下面的示例文件中，Rory 和 Jackson 是新联系人，它们被关联到现有联系人的唯一标签上，并使用其电子邮件值作为唯一标识符。Sookie 是一个现有联系人，被关联到两个具有相同标签的现有联系人上。在第一行中，关联标签是一对标签中的一部分，这意味着导入完成后，被关联的记录将具有“Parent”标签，而 Rory将具有配对标签“Child”。
父/子关联
若要通过导入创建子公司与母公司的关联，请了解有关导入子公司的更多信息。
自定义关联标签
需要订阅 使用自定义关联标签需要Professional 或 Enterprise订阅。
要导入关联标签，请包含 “关联标签”列。仅当您希望添加标签来描述关联关系时，才应添加此列。如果您不需要为关联关系添加标签，则无需添加该列。
- 您必须在导入前先在 HubSpot 中创建关联标签。
- 若要将公司关联设为主关联，请在该行的“关联标签”列中填写值“Primary”。
- 若要设置多个标签来描述两条记录之间的关系，可在一个单元格中输入多个关联标签值，并用分号分隔（例如：经理；账单联系人）。
示例文件
在导入过程开始时，您可以生成一个示例文件，其中包含所选对象和活动的必需属性。如果您想查看包含更多属性的示例，请参阅这篇附有示例文件的文章。
后续步骤
现在导入文件已准备就绪，请按照相应的导入说明操作：
