Start Strong
Sell Smart
Manage with Ease
Market to Success

通过 CSV 文件批量创建和更新商品

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

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

 

 

批量更新商品信息

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

  1. 在 SHOPLINE 后台，前往【商品】页面。点击页面右上角的【导入】按钮，并选择【本地导入】。

  2. 在弹窗中，根据您的使用场景选择相应的文件：

    • 商品模板： 下载空白模板，用于批量创建新商品或准备待导入的商品数据。

    • 导出商品： 导出现有商品数据，修改后再重新导入 SHOPLINE，以批量更新现有商品。

  3. 按照模板规范填写商品信息，并将文件保存至本地。

  4. 在导入弹窗中，点击上传区域或拖拽文件上传。

  5. 根据需要勾选导入设置：

    • 【覆盖相同 handle 商品】：当表格中的 Handle 与现有商品一致时，将更新该商品。无 Handle 的商品将被创建为新商品。
    • 【忽略空白字段】：文件中的空白字段不会覆盖现有数据。若未勾选，空白字段将清空原有值。
    • 【仅更新商品元字段信息】：仅根据 Handle 列更新现有商品的元字段，不会创建新商品。
  6. 点击【上传并导入】开始导入。

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

注意：

  • 您的商店最多可同时执行 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 匹配，该字段在更新时不会被覆盖，但所有其他相关信息将被更新。
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 个字符；超出同样会导致导入失败。
Image Alt Text（选填） 商品图片的替代文本（用于 SEO 和无障碍）
  • 该列必须保留，但值可以留空。
  • 最大长度为 512 个字符；超出部分将自动截断。
SEO title（选填） 商品页面的 SEO 标题（显示在搜索结果中）
  • 该列必须保留，但值可以留空。
  • 建议包含商品核心关键词。
  • 最大长度为 255 个字符；超出可能会被截断，并可能影响 SEO 表现。
  • 对于多规格商品，仅需填写第一行，其余行可以留空。
SEO description（选填） 商品页面的 Meta 描述（显示在搜索结果中）
  • 该列必须保留，但值可以留空。
  • 建议保持简洁并包含核心关键词。
  • 最大长度为 1,024 个字符；超出可能会被截断，并可能影响 SEO 表现。
  • 对于多规格商品，仅需填写第一行，其余行可以留空。
SEO keywords（选填） 商品的 SEO 关键词
  • 该列必须保留，但值可以留空。
  • 建议使用与商品相关的高频关键词。
  • 多个关键词使用逗号分隔。每个商品最多 50 个关键词；超出部分将被忽略。
  • 总长度限制为 500 个字符；超出将视为未提供该字段。
  • 对于多规格商品，仅需填写第一行，其余行可以留空。
Published（选填） 商品是否发布到线上商店
  • 该列必须保留，但值可以留空。
  • 输入"Y" 表示发布，"N" 表示不发布。
  • 留空时默认值为 "Y"。
  • 无效值将被视为 "Y"。
  • 对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为 "Y"。
  • 对于多规格商品，仅需填写第一行，其余行可以留空。
Status（选填） 商品可用状态
  • 该列必须保留，但值可以留空。
  • 支持的值为"Y"（启用）、"N"（草稿）和 "archived"（已归档）。
  • 留空时默认值为"Y"。
  • 无效值可能会被转换为默认值 "Y"。
  • 对于本地导入，值遵循开关规则；对于其他导入方式，该值将被设置为"Y"。
  • 对于多规格商品，仅需填写第一行，其余行可以留空。
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 个字符；超出将导致导入失败。
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 功能使用感受或需求建议，快点击【功能反馈】告诉我们吧！