上次更新时间： 2026年4月14日
在将数据导入 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 默认枚举属性（例如“生命周期阶段”、“行业”），值必须与内部值或英文标签相匹配。 |
| 文件 |
|
| 多个复选框 |
若要导入多个值，请在每个值之间添加分号且不留空格（value 1;value 2）。这些属性选项必须在导入前创建。 若要添加或追加值，请在第一个值前添加分号（;值 3;值 4）。这将追加该值，而非覆盖现有属性值。 了解有关导入多个复选框值的更多信息。 |
| 数字 |
根据创建的数字属性类型设置值格式：
|
| 单选复选框 |
为单选框字段创建一列，并将每行的值设置为“True”或“Yes”，在 HubSpot 中显示为“Yes”或已选中；或设置为“False”或“No”，在 HubSpot 中显示为“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 年）。
若导入“计费频率”属性值，当产品采用周期性定价时，请使用“每月”、“每年”或“每季度”
；
若产品采用一次性定价，请将单元格留空。
包含必填属性
根据您导入的对象或活动类型，以下属性是创建记录的必填项，必须作为列标题包含在文件中。 若需更新记录，必须包含唯一标识符（例如：记录 ID、电子邮件、公司域名）。
虽然并非强制要求，但您可以为每个对象导入其他属性，包括自定义属性和默认属性。请参考联系人、公司、商机、工单、通话、电子邮件、会议、笔记 和任务的默认属性。您还可以在属性设置中查看所有属性及其值。
- 联系人：至少包含“名字”、“姓氏”或“电子邮件”其中一项。
- 公司：至少包含 “名称”或“公司域名”其中一项。
请注意： 公司域名属性仅接受顶级域名（例如 .com、.edu）作为值。导入时，包含顶级域名后缀的值（例如 .edu/home）将被自动删除。
- 商机：若创建新商机，需包含“商机名称”、“销售流程”和“商机阶段”。“销售流程”和“商机阶段”必须与您账户中的现有选项匹配，且“商机阶段”必须是该销售流程中的有效阶段。
- 工单：若 您正在创建新工单，请填写“工单名称”、“销售管道”和“工单状态”。
- 预约：预约开始时间。该时间应格式化为日期时间属性。
- 课程：课程名称。
- 房源：名称。
- 服务：名称、销售管道和销售阶段。
- 产品：若 您正在更新产品，请提供记录 ID或SKU。
- 订单：名称、销售漏斗及销售漏斗阶段。
- 购物车：名称。
- 明细行： 名称、数量、价格以及关联交易的记录 ID 或 交易名称。 如果您 还 需 将明细行与产品关联 ，请 包含该产品的 Product ID， 该字段将在导入过程中映射为明细行属性。
请注意：当与交易关联导入明细行时，导入操作不会更新交易金额。若要更新关联交易的金额，您可以在 HubSpot 中手动编辑明细行，或将明细行与交易进行关联。
- 通话： 通话记录。导入新通话时，建议同时包含 活动日期。
- 电子邮件： 邮件正文和 邮件发送方向。
- 会议：会议描述、会议开始时间和会议结束时间。导入新会议时，建议同时包含 活动日期。开始时间、结束时间和活动日期值应格式化为日期时间属性。
- 备注：备注正文。
- 任务：任务标题和截止日期。 截止日期应格式化为日期时间属性。
请注意：虽然并非必需，但在导入新活动时，建议包含“活动日期”以指定活动发生的日期和时间。如果您未包含此属性，则“活动日期”值将自动设置为导入时的日期和时间。
更新现有记录
或
避免重复记录
的要求
为更新现有记录并避免重复记录，您的文件必须为每个对象包含一个唯一标识符属性。对于所有对象，您可以 导出现有记录 并使用 “记录 ID”作为唯一标识符，或使用要求唯一值的自定义属性。 对于联系人，您还可以使用“电子邮件 ” 。对于公司，您还可以使用“公司域名”。
如果您正在导入多个对象且包含“记录 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”。
父/子关联
若需通过导入创建公司父子关联，请了解有关导入子公司（子公司）的更多信息。
自定义关联标签
需要订阅 使用自定义关联标签需要Professional 或 Enterprise订阅。
若要导入关联标签，请包含 “关联标签”列。仅当您希望添加标签来描述关联关系时才应添加此列。若无需为关联关系添加标签，则无需此列。
- 您必须在导入前于 HubSpot 中创建关联标签。
- 若要将某家公司关联设为主要关联，请在该行的“关联标签”列中输入值“Primary”。
- 若需使用多个标签描述两条记录之间的关系，可在单个单元格中输入多个关联标签值，并用分号分隔（例如：经理; 账单联系人）。
示例文件
在导入过程开始时，您可以生成一个示例文件，其中包含所选对象和活动所需的属性。如果您希望查看包含更多属性的示例，请参阅这篇附有示例文件的文章。
后续步骤
现在您的导入文件已准备就绪，请按照相应的导入说明操作：
