通过 CSV 文件批量创建和更新商品 – SHOPLINE 常见问题

如果您需要批量创建新商品或更新现有商品，可以使用 SHOPLINE 的【商品模板】或导出的商品信息文件，将商品数据导入店铺。这两种文件采用相同的字段结构，您既可以创建新商品、更新现有商品信息，也可以修改导出的商品信息后再重新导入 SHOPLINE。

本指南将介绍如何下载合适的文件、了解各字段及其填写要求、创建标准商品和多规格商品、导入商品数据，以及排查常见的导入问题。

批量更新商品信息

您可以通过商品表格批量导入商品信息，快速完成商品创建或更新。请依以下步骤完成导入操作：

在 SHOPLINE 后台，前往【商品】页面。点击页面右上角的【导入】按钮，并选择【本地导入】。
在弹窗中，根据您的使用场景选择相应的文件：
- 商品模板： 下载空白模板，用于批量创建新商品或准备待导入的商品数据。
- 导出商品： 导出现有商品数据，修改后再重新导入 SHOPLINE，以批量更新现有商品。
按照模板规范填写商品信息，并将文件保存至本地。
在导入弹窗中，点击上传区域或拖拽文件上传。
根据需要勾选导入设置：
- 【覆盖相同 handle 商品】：勾选后，如果文件中的 Handle 与现有商品一致，将覆盖该商品。若未勾选，系统会自动为重复的 Handle 添加数字后缀，并将其作为新商品导入。无论是否勾选此选项，没有 Handle 的商品都会作为新商品创建。
- 【忽略空白字段】：文件中的空白字段不会覆盖现有数据。若未勾选，空白字段将清空原有值。
- 【仅更新商品元字段信息】：仅根据 Handle 列更新现有商品的元字段，不会创建新商品。
点击【上传并导入】开始导入。

导入完成后，您可返回【商品】页面查看已导入或更新的商品。

注意：

您的商店最多可同时执行 4 个导入任务和 10 个导出任务。若达到对应任务类型的数量上限，相关操作按钮将暂时不可用，直到其中一个进行中的任务完成后才会恢复使用。
支持的文件格式为 .xlsx、.xls、.csv，文件大小不得超过 40MB。
若上传失败，请检查：
- 文件格式是否正确。
- 是否按照模板规范填写。
若您的店铺启用了多个库存地点，库存数量无法通过该入口更新，请前往库存管理页面使用库存表格导入。

表格模板说明

请使用 Chrome 浏览器下载表格。
SHOPLINE 使用 CSV 文件对海量商品进行批量导入、导出管理。CSV 有着依靠较小的文件体积便可以保存大量数据的优点。

目前 SHOPLINE 仅能识别格式正确的 CSV 的文件。CSV 是较为特殊的一种数据存储文件格式，Microsoft Excel 部分版本无法正确打开 CSV 文件，请使用专业的 CSV 编辑器或者 WPS 软件对文件进行编辑、保存，避免文件格式损坏无法顺利导入商品信息。

注意：当您使用工具编辑CSV文件时，单元格内的字符数请勿超过工具所支持的最大字符数，否则可能出现格式异常情况。Microsoft Excel与WPS一个单元格最大支持32767字符，Numbers一个单元格最大支持1000000字符。

请勿随意修改模板文件中第一行的字段内容及字段顺序，对第一行表头内容进行修改、调换顺序，可能会导致 SHOPLINE 对上传的表格内容无法识别，导致商品信息导入失败。

注意：若您已通过表格导出店铺 A 的商品并计划于店铺 B 做导入，在导入过程中提示“表头不符合规范，请检查后重新上传”时，请做以下检查并修改。

检查店铺 A 是否已开启了【市场】对应功能，若开启了【市场】功能，在店铺 A 导出的商品表格中首行将具备商品于对应【市场】的相关信息：Included /{主市场}、Inclueded /{其他市场}、Price/{其他市场}。
若您于店铺 B 暂不需要进行【市场】相关功能及信息配置，您可于店铺 A 导出的表格中删除对应列保存后重新导入即可。

表格字段介绍和说明

下载【商品模板】或导出现有商品资料后，您可以使用电子表格批量创建新商品或更新现有商品。除非另有说明，以下字段说明及填写要求同时适用于这两种文件。

带*号的为必填项。
请严格遵守商品信息填写规范，以免商品批量导入失败。
在进行覆盖更新时，SHOPLINE 将会覆盖具有相同 handle 的任何现有产品，现有的值将用于任何缺少的列。

备注：假设现有商品中的 Brand 值为 Apple，但导入的 CSV 文件中对应商品的 Brand 列为空则导入后该商品的品牌信息 Apple 将被覆盖为空

字段名称

说明

规则 / 注意事项

Product id（仅适用导出表格）

系统为每个商品生成的唯一 ID，用于商家检索 product_id

导入时填写的任何值将被忽略。
最大长度为 64 个字符。

Variant id（仅适用导出表格）

系统为每个规格生成的唯一 ID，用于在更新时识别已有规格

在导入模板中，此字段不会显示。但若手动添加并用于更新，该字段将会生效。

注意：常用于需要修改规格或规格值（Option1–5 name 及其 value）但不希望变更 variant_id 的场景，以避免对广告投放和数据追踪造成影响。
选填，但在更新已有规格时为必填。
必须属于由 Handle 标识的商品，否则不匹配将导致导入失败。

Handle（选填）

由商品标题生成的唯一商品标识，用于导入时作为匹配商品的主要标识

该列必须保留，但值可以留空。
更新时必须与现有 Handle 完全匹配，否则将被视为新商品。
- 如果匹配成功，商品将被更新。
- 如果未匹配，则会创建新商品。
对于多规格商品，仅需填写第一行，其余行可以留空。
空格和特殊字符会自动转换为"-"（例如："apple phone" → "apple-phone"）。

注意： 如果 Handle 与现有商品一致，更新商品时不会覆盖 Handle，但会更新商品的其他相关信息。具体处理方式取决于导入时是否勾选【覆盖相同 handle 商品】：

勾选：覆盖 Handle 相同的现有商品。
未勾选：SHOPLINE 会自动在重复的 Handle 后添加数字后缀，生成唯一的 Handle，并将其作为新商品导入。

Title（必填）

商品名称或标题

该列必须保留，且不能为空。
最大长度为 255 个字符；超过此限制将导致导入失败。
对于多规格商品，仅需填写第一行，其余行可以留空。
此字段不受【忽略空白字段】设置影响。留空将导致导入失败。

Subtitle（选填）

商品副标题或标语

该列必须保留，但值可以留空。
最大长度为 400 个字符；超出部分将自动截断。
对于多规格商品，仅需填写第一行，其余行可以留空。

Product description html（选填）

商品详细描述

该列必须保留，但值可以留空。
支持纯文本和 HTML。
- 如需应用换行或加粗等格式，需要使用 HTML 代码。
- 对于纯文本，可直接输入内容，无需额外样式。
对于多规格商品，仅需填写第一行，其余行可以留空。

SPU（选填）

商家自定义的商品内部标识

该列必须保留，但值可以留空。
最大长度为 255 个字符；超过此限制将导致导入失败。
不支持表情符号，否则会导致导入失败。
对于多规格商品，仅需填写第一行，其余行可以留空。

Vendor（选填）

商品品牌或制造商

该列必须保留，但值可以留空。
最大长度为 255 个字符；超出部分将自动截断。
对于多规格商品，仅需填写第一行，其余行可以留空。

Tags（选填）

用于分类和搜索筛选的标签

该列必须保留，但值可以留空。
在同一行中输入多个标签，使用逗号分隔（例如：red, summer）。
标签不区分大小写（ABC = abc）。
每个商品最多允许 250 个标签；超出部分将被忽略。
对于多规格商品，仅需填写第一行，其余行可以留空。

Collections（选填）

商品所属的商品系列 Handle

该列必须保留，但值可以留空。
使用商品系列的 handle（而非标题），空格需转换为"-"。
多个系列 handle 使用逗号分隔。
不支持智能商品系列。
对于多规格商品，仅需填写第一行，其余行可以留空。

警告：如果从表格中删除此列，现有商品系列可能会被清除，请谨慎操作。

Master image（选填）

商品主图 URL

该列必须保留，但值可以留空。
每行输入一个图片 URL；每个商品最多支持 500 张图片。
支持的格式包括 JPG、JPEG、PNG、GIF 和 WebP。
每张图片不得超过 10MB；超出将导致导入失败。
每个图片 URL 的最大长度为 512 个字符；超出同样会导致导入失败。

注意：通过此字段导入图片 URL 时，系统始终会在【文件库】中创建新的图片副本，即使该图片已存在于文件库中。若要避免产生重复图片，请逐个创建商品，而不要使用批量导入。

Image Alt Text（选填）

商品图片的替代文本（用于 SEO 和无障碍）

该列必须保留，但值可以留空。
最大长度为 512 个字符；超出部分将自动截断。

SEO title（选填）

商品页面的 SEO 标题（显示在搜索结果中）

该列必须保留，但值可以留空。
建议包含商品核心关键词。
最大长度为 255 个字符；超出可能会被截断，并可能影响 SEO 表现。
对于多规格商品，仅需填写第一行，其余行可以留空。

SEO description（选填）

商品页面的 Meta 描述（显示在搜索结果中）

该列必须保留，但值可以留空。
建议保持简洁并包含核心关键词。
最大长度为 1,024 个字符；超出可能会被截断，并可能影响 SEO 表现。
对于多规格商品，仅需填写第一行，其余行可以留空。

Published（选填）

商品是否发布到在线商店销售渠道。

该列必须保留，但值可以留空。
输入"Y" 表示将商品发布到在线商店渠道，"N" 表示不在该渠道发布。
留空时默认值为 "Y"。
无效值将被视为 "Y"。
对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为 "Y"。
对于多规格商品，仅需填写第一行，其余行可以留空。

Status（选填）

商品在所有销售渠道中的可用状态

该列必须保留，但值可以留空。
支持的值为"Y"（上架）、"N"（下架）和 "Archived"（已存档）。
留空时默认值为"Y"。
无效值会被转换为默认值 "Y"。
对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为"Y"。
对于多规格商品，仅需填写第一行，其余行可以留空。

Unlisted（选填）

设置商品是否可在店铺商品列表、搜索结果、推荐位和搜索引擎中显示。

此列必须保留，但值可以留空。
输入 "Y" 可将商品设置为不可见，使其不会显示在店铺商品列表、搜索结果、推荐位或搜索引擎中；输入 "N" 则保持商品可见。
创建新商品时，如果此字段留空，系统默认设置为 "N"（可见）。
更新已有商品时，如果此字段留空，系统将保留当前可见状态。
如果输入无效值，系统将按 "N"（可见）处理。
对于包含多个变体的商品，仅需在第一行填写该字段，后续变体行可留空。

Standardized Product Type（选填）

标准商品分类（基于 Google 商品类别），用于税费计算

该列必须保留，但值可以留空。
该值必须从预定义分类列表中选择。SHOPLINE 以 Google 商品类别为标准分类数据源。导入时支持填写分类名称（name）或完整分类路径（full name/分类路径）。
自定义或无效值可能会导致税费计算错误。
对于多规格商品，仅需填写第一行，其余行可以留空。

Custom Product Type（选填）

商家自定义商品分类

该列必须保留，但值可以留空。
最大长度为 255 个字符；超过此限制将导致导入失败。
对于多规格商品，仅需填写第一行，其余行可以留空。

Created time（选填）

商品创建时间

该列必须保留，但值可以留空。
该字段通常无需填写，适用于数据迁移等场景（如从其他平台导入历史商品数据），用于保留原有商品的创建时间。
值必须符合 ISO 8601 格式。
日期不得早于 1990-01-01T00:00:00+08:00。
留空时将使用系统当前时间。
对于多规格商品，仅需填写第一行，其余行可以留空。

SKU（选填）

商家自定义规格标识

该列必须保留，但值可以留空。
在上传 CSV 文件并勾选 "更新/覆盖相同商品" 时，若该字段留空，系统会使用已有值填充缺失列，但现有 SKU 将被清除。
每个商品内的 SKU 必须唯一。
每个商品最多支持 500 个 SKU；每个 SKU 最大长度为 255 个字符。
对于多规格商品，此字段需逐行填写。

Option1 name（选填）

第一个规格属性名称（例如：颜色）

该列必须保留，但值可以留空。
此字段不受【忽略空白字段】 设置影响。在更新 CSV 文件时，请勿清空该字段，否则将删除原有规格结构。
一个商品最多可有 5 个规格属性名称；每个名称最大长度为 255 个字符。
对于多规格商品，仅需填写第一行，其余行可以留空。

警告：更新时清空该字段可能会移除现有规格结构。

Option1 value（选填，但当 Option1 name 有值时为必填）

第一个规格属性值

若对应的属性名称有值，则此字段为必填。
该列必须保留，但值可以留空。
此字段不受【忽略空白字段】设置影响。在更新 CSV 文件时，请勿清空该字段，否则将删除原有规格值。
每个单元格仅可填写一个值。
去除空格后重复的值不允许，将导致导入失败。
应根据规格组合逐行填写（例如：Red-S、Red-M 需分别填写在不同的行）。

警告：更新时清空该字段可能会移除现有规格值。

Option2–Option5 name（选填）

第二至第五个规格属性名称

规则与 Option1 name 相同。

Option2–Option5 value（选填，但当对应的 Option name 有值时为必填）

第二至第五个规格属性值

规则与 Option1 value 相同。

Option1 value image（选填）

第一个规格值对应的图片 URL

该列必须保留，但值可以留空。
每个规格值仅支持一张图片。
支持的格式包括 JPG、JPEG、PNG、GIF 和 WebP。
每张图片不得超过 10MB。
每个 URL 的最大长度为 512 个字符；超出将导致导入失败。

注意：与 Master image 相同，通过此字段导入图片 URL 时，系统始终会在【文件库】中创建新的图片副本，即使该图片已存在于文件库中。若要避免产生重复图片，请逐个创建商品，而不要使用批量导入。

Option2–Option5 value image（选填）

第二至第五个规格值对应的图片 URL

规则与 Option1 value image 相同。

Image（选填）

SKU（规格）对应的图片 URL

该列必须保留，但值可以留空。
每个 SKU 仅支持一张图片。
支持的格式包括 JPG、JPEG、PNG、GIF 和 WebP。
每张图片不得超过 10MB。
每个 URL 的最大长度为 512 个字符；超出将导致导入失败。

SKU Image Alt Text（选填）

SKU 图片的替代文本

该列必须保留，但值可以留空。
最大长度为 512 个字符；超出部分将自动截断。

SKU price（选填）

规格售价

该列必须保留，但值可以留空。
仅输入数字，不包含货币符号。
支持最多 2 位小数。
留空时默认值为 0。
负值将被转换为 0。
超过 11 位的数值将被截断为 11 位（最大值：99999999999）。
无规格商品仅需填写第一行；多规格商品需逐行填写。

SKU compare at price（选填）

规格原价

该列必须保留，但值可以留空。
仅输入数字，不包含货币符号。
支持最多 2 位小数。
留空时默认值为 0。
负值将被转换为 0。
超过 11 位的数值将被截断为 11 位（最大值：99999999999）。
无规格商品仅需填写第一行；多规格商品需逐行填写。

SKU weight（选填）

规格重量数值

该列必须保留，但值可以留空。
仅输入数字，最多支持 2 位小数。
负值将被转换为 0。
非数字值将导致导入失败。
超过 12 位的数值将被截断为 12 位（最大值：999999999999）。
无规格商品仅需填写第一行；多规格商品需逐行填写。

SKU weight unit（选填）

规格重量单位

该列必须保留，但值可以留空。
支持的值为 g、kg、lb 和 oz。
无效值将自动转换为 g。
当未启用【忽略空白字段】时，留空将重置为 g。
无规格商品仅需填写第一行；多规格商品需逐行填写。

SKU Inventory Tracker（选填）

是否启用库存追踪

该列必须保留，但值可以留空。
输入 "T" 表示启用，"F" 表示禁用。
留空时默认值为 "T"。
无效值将被视为 "T"。
对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为 "Y"。
对于多规格商品，仅需填写第一行，其余行可以留空。

SKU Inventory Policy（选填）

规格超卖规则

该列必须保留，但值可以留空。
输入"continue" 表示允许超卖，"deny" 表示不允许。留空时默认值为 "deny"。
无效值将被视为 "deny"。
对于多规格商品，此字段需逐行填写。

SKU Inventory Quantity（选填）

规格库存数量

该列必须保留，但值可以留空。
仅支持整数。
数值范围为 -999,999,999 至 999,999,999。
非数字值将被转换为 0。
启用多库存地点时，该字段不生效。如果您希望批量更新多个库存地点的库存，请使用【库存批量更新】功能。详细操作步骤，请参阅《通过 CSV 文件更新库存》。
覆盖更新时留空将保留原库存；未启用【忽略空白字段】时留空将重置为 0。

Cost per item（选填）

单件成本价

该列必须保留，但值可以留空。
仅输入数字，不包含货币符号。
支持最多 2 位小数。
超过 11 位的数值将被截断为 11 位（最大值：99999999999）。
无规格商品仅需填写第一行；多规格商品需逐行填写。

Barcode（ISBN, UPC, GTIN 等）（选填）

用于物流与库存追踪的条码

该列必须保留，但值可以留空。
最大长度为 255 个字符。
建议确保唯一性以避免冲突。
对于多规格商品，此字段需逐行填写。

SKU tax policy（选填）

是否对规格征税

该列必须保留，但值可以留空。
输入 "T" 表示需征税，"F" 表示免税。
留空时默认值为 "T"。
无效值将被视为 "T"。
对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为 "Y"。

SKU shipping policy（选填）

是否需要配送

该列必须保留，但值可以留空。
输入 "T" 表示需要配送，"F" 表示不需要。
留空时默认值为 "T"。
无效值将被视为 "T"。
对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为 "Y"。

Path（选填）

自定义商品页面 URL 路径（相对路径）

该列必须保留，但值可以留空。
仅输入相对路径，不包含域名。
最多支持 5 层路径，最大长度为 512 个字符。
不允许使用系统保留前缀。
无效值不会阻止导入，但可能导致 URL 更新失败。

注意：

不支持以"/collections"或"/products"开头的路径。
需启用自定义 URL 功能。

Gift card（选填）

商品是否为礼品卡

该列必须保留，但值可以留空。
输入 "T" 表示是，"F" 表示否。
留空时默认值为 "F"。
无效值将被视为 "T"。
对于多规格商品，仅需填写第一行，其余行可以留空。
对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为 "N"。

HS code（选填）

报关用 HS 编码

该列必须保留，但值可以留空。
必须为 6 至 12 位数字；格式无效将导致导入失败。
对于多规格商品，此字段需逐行填写。

Shipping origin（选填）

发货地国家/地区代码

该列必须保留，但值可以留空。
必须为有效的国家或地区代码；无效将导致导入失败。
对于多规格商品，此字段需逐行填写。

Included / market（仅适用导出表格）

商品是否发布到指定市场

该列必须保留，但值可以留空。
输入 "TRUE" 表示发布，"FALSE" 表示不发布。
默认导入模板不包含该列，仅在导出文件中提供。
每个市场对应一个单独的列（例如：Included / United States）。

Price / market（仅适用导出表格）

SKU 在指定市场的售价

该列必须保留，但值可以留空。
仅输入数字，不包含货币符号（例如：9.99）。
货币以店铺中配置的市场货币为准。
无规格商品仅需填写第一行；多规格商品需逐行填写。
默认导入模板不包含该列，仅在导出文件中提供。
每个市场对应一个单独的列（例如：Price / Europe）。

Metafield Description（仅适用导出表格）

商品元字段值

字段结构取决于店铺中配置的元字段定义。
值必须符合元字段定义的数据类型（例如：文本、数字、URL、布尔值）。
无效值可能导致导入失败或被忽略。

如何联系我们

SHOPLINE 拥有专业的本地支持团队，为有需求和疑惑的商家提供帮助。您可以通过联系 SHOPLINE 店铺后台及官方网站的实时客服来寻求 SHOPLINE 的帮助。
*如有 SHOPLINE 功能使用感受或需求建议，快点击【功能反馈】告诉我们吧！