上次更新时间： 2025年11月20日
在将数据导入HubSpot之前，请查看以下限制和要求。您还可以访问示例文件或生成示例文件以开始操作。
若需了解导入工具详情，请参阅本文。文件准备就绪后，请学习导入方法。
技术要求与限制
导入至HubSpot的所有文件必须满足：- 为 .csv、.xlsx 或 .xls 格式文件。
- 仅包含一个工作表。
- 包含标题行，其中每个列标题需与HubSpot属性对应。列标题顺序可自由调整，不影响导入。导入前可确认是否存在与 标题匹配的默认属性， 或创建自定义属性。了解属性要求详情。
- 列数少于1000列。
- 若包含外语字符，请采用UTF-8编码。
- 若导入Excel文件：
- 数据量需低于Excel工作表及工作簿的最大容量限制。
- 导入日期和时间选择器属性时，单元格需采用数字格式。
根据您的HubSpot订阅类型，导入工具还存在其他技术限制。这些限制包括导入文件的大小和行数限制，以及每日可导入的文件数量和行数上限。
- 若仅使用HubSpot免费版或Smart CRM专业版/企业版工具 ，您可：
- 导入文件大小上限为20MB。
- 每日最多完成50次导入操作。
- 每日最多导入500,000行数据。若导入文件超过500,000行，则需多日完成处理。
- 若您的账户订阅了入门版、专业版或企业版，您可：
- 导入文件大小上限为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 以在 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年）
若导入计费频率属性值，当产品采用周期性定价时，请使用monthly（每月）、annually（每年）或quarterly（每季度）。若产品为一次性定价，请将单元格留空。
必填属性
根据导入对象或活动的类型，创建记录时需包含下列必填属性，且必须作为文件中的列标题。若更新记录，则必须包含唯一标识符（如记录ID、邮箱、公司域名）。
虽然非必需，但您可为每个对象导入额外属性，包括自定义属性与默认属性。请参考联系人、公司、商机、工单、通话、邮件、会议、笔记和 任务的默认属性。您还可在属性设置中查看所有属性及其值。
- 联系人：至少包含以下一项：名字、姓氏或 电子邮件。
- 公司：至少包含 名称或公司域名其中一项。
请注意： 公司域名属性仅接受顶级域名（如.com、.edu）前的值。导入时，域名后缀（如.edu/home）将被自动移除。
- 交易：若创建新交易，需提供交易名称、销售渠道及交易阶段。
- 工单： 创建新工单时需填写 工单名称、流程和 工单状态。
- 预约：预约开始时间。该字段需以日期时间属性格式填写。
- 课程：课程名称。
- 房源：名称。
- 服务：名称、销售渠道及 销售阶段。
- 产品：若 更新产品，需提供记录ID或SKU。
- 订单：名称、销售渠道及 渠道阶段。
- 购物车：名称。
- 明细行： 名称、数量 、价格及 关联交易的记录ID或 交易名称。 若同时 关联产品，请包含 产品ID， 该ID将在导入时映射为明细行属性。
请注意：导入含交易的明细行时，导入操作不会更新交易金额。若需更新关联交易金额，可手动编辑明细行或在HubSpot中将明细行关联至交易。
- 通话记录： 通话备注。导入新通话时建议同时包含活动日期。
- 邮件： 邮件正文及 邮件方向。
- 会议：会议描述、会议开始时间、会议结束时间。导入新会议时，建议同时包含活动日期。开始时间、结束时间及活动日期值应采用日期时间属性格式。
- 备注：备注正文。
- 任务：任务标题和 截止日期。 截止日期 应采用日期时间属性格式。
请注意：虽然非必需，但导入新活动时建议包含活动日期以指定活动发生的时间。若未包含此属性，系统将自动将活动日期值设为导入当天的日期和时间。
更新现有记录或避免重复项的要求
为更新现有记录并避免重复，您的文件必须为每个对象包含唯一标识符属性。对于所有对象，可 导出现有记录 并使用 记录ID作为唯一标识符，或使用要求唯一值的自定义属性。 对于联系人，也可使用电子邮件地址；对于公司，还可使用公司域名。
若导入多个对象且包含记录ID，建议区分文件列标题以匹配对应对象（例如：一列命名为"记录ID - 联系人"，另一列命名为"记录ID - 公司"）。
请注意： 当文件包含 电子邮件或公司域名 时，将遵循以下规则 ：
- 若使用自定义唯一值属性进行联系人去重，电子邮件属性仍需保持唯一性。
- 若使用自定义唯一值属性进行企业去重，则企业域名属性无需唯一值。这意味着可导入重复企业域名。若需避免重复域名的企业存在，请在导入前从文件中移除重复域名，或改用企业域名作为唯一标识符。
- 对于已在HubSpot中登记备用邮箱的现有联系人，可使用备用邮箱作为唯一标识符。若使用备用邮箱且 文件中未包含 记录ID列，则备用邮箱不会替换主邮箱。但若文件同时包含备用邮箱和记录ID两列，则备用邮箱将替换主邮箱。
关联记录的要求
单文件导入关联关系
在单个文件中，每行可关联两个或多个记录。同一行内需包含关联记录和/或活动的详细信息，并为每个对象添加唯一标识符。若需将单个记录关联至多个活动或另一个对象的记录，请为每个关联对象在多行中分别添加该记录的唯一标识符。
例如：卢克·丹尼斯在卢克餐厅担任经理，同时在蜻蜓旅馆担任承包商。要将其关联至两家公司，需为卢克·丹尼斯创建两行记录，每行包含电子邮箱（或记录ID）及对应公司的域名（或记录ID）字段。
请注意：若 未包含唯一标识符（如电子邮箱、公司域名、 记录ID），导入操作将创建重复记录而非关联至同一记录。
若导入相同对象关联，则需满足额外要求。
请将关联关系分两个文件导入
要关联两个文件中两个对象的记录，请使用公共列连接每个文件中的记录。可参考示例文件获取更多导入和关联记录的帮助。
同对象关联
可批量导入单个文件关联相同对象的记录。导入过程中需勾选复选框以包含相同对象关联。
设置文件时，请在同一行中包含关联记录的信息，并为每条记录添加唯一标识符。以下附加要求专用于相同对象导入：
- 记录对中至少有一条记录需在导入前已存在于HubSpot。例如：可导入新联系人并关联现有联系人，但无法同时创建并关联两个新联系人。
- 关联现有联系人/公司时，仅支持使用主邮箱/公司域名作为唯一标识符，次要邮箱或域名不被支持。
- 若需将多条记录关联至单条记录，请在同一单元格内用分号分隔各记录的唯一标识符值（例如：luke@lukesdiner.com;rory@yale.edu;sookie@dragonfly.com）。
在下面的示例文件中，Rory和Jackson是通过电子邮件值作为唯一标识符关联到现有联系人并带有唯一标签的新联系人。Sookie是现有联系人，被关联到两个具有相同标签的现有联系人。在第一行中，关联标签属于标签对，这意味着导入完成后，关联记录将获得"Parent" 标签，而Rory 将获得配对标签"Child"。
父/子关联
若需通过导入创建子-母公司关联，请参阅导入子公司指南。
自定义关联标签
需要订阅 使用自定义关联标签需订阅专业版或 企业版。
导入关联标签时，请包含" 关联标签"列 。仅当需要添加描述性标签时才添加此列。若无需标注关联关系，则该列非必需。
- 导入前必须在HubSpot中创建关联标签。
- 若需将公司关联设为主要关联，请在该行关联标签列中 填写值Primary。
- 若需为两条记录间的关系添加多个描述标签，可在单个单元格内输入多个关联标签值，用分号分隔（例如：经理; 账单联系人）。
- 若 通过多文件导入关联标签，需在同一文件中包含"关联标签" 列及被关联对象的唯一标识符。
- 若导入配对标签：
- 跨对象关联时，仅需在关联标签列中填写其中一个标签。导入过程中系统将自动为对应对象分配正确标签。
- 对于同一对象关联： 关联[唯一标识符]列中的记录 将接收导入过程中添加或 文件标签列包含的标签。该行另一记录将接收配对中的另一标签。
示例文件
导入开始时，可生成包含所选对象及活动所需属性的示例文件。若需查看更多含附加属性的示例，请参阅本文提供的样本文件。
