帮助
登录

使用 CSV 文件导入和导出产品

您可以使用 CSV（逗号分隔值）文件将产品导入 Shopify 商店以及从商店中导出产品。使用 CSV 文件时，您可以同时导入或导出大量产品及其详细信息。如果您想在 Shopify 和其他平台之间交换产品信息，这会很有帮助。

若要详细了解如何使用 CSV 文件，请参阅打开和编辑 CSV 文件。

在此页面上

下载 CSV 示例文件

您可以下载并查看产品 CSV 示例文件以用作模板。如果您使用该示例文件，请注意以下详细信息：

  • 示例文件包含两个示例产品，并包括一些多属性。您的导入文件可能包含更多产品和多属性。如果您使用示例文件创建自己的导入文件，请务必删除所有示例产品。
  • 该示例文件包含 Inventory quantity 列，该列仅适用于只有一个地点的商店。如果您使用多个地点并且想导入或导出库存数量，则请使用库存 CSV 文件。
  • 该示例文件包括 Price / International 和 Compare-at price / International 列，但这些列留为空白，因为示例产品在进行国际销售时没有任何独特的定价。详细了解国际 CSV 列。

产品 CSV 文件的注意事项

在使用产品 CSV 文件之前，请查看以下注意事项。

设置产品 CSV 文件的格式

为确保您的产品 CSV 文件正常运行，请验证它是否满足以下条件：

  • 您的产品 CSV 文件的第一行必须是产品 CSV 描述表中指定的列标头。
  • 每列必须用逗号分隔。

产品 CSV 文件中的必需列

在以下情况下，必须提供这些列：

  • 创建用于导入新产品的产品 CSV 文件时，唯一必需的列是 Title。如果您要为产品添加多属性，则还必须包含 URL handle 列。
  • 使用 CSV 文件更新产品时，唯一必需的列是 URL handle 和 Title。

数据依赖关系

即使 Title 和 URL handle 列是使用 CSV 文件更新产品时唯一必需的列，但某些列中的数据取决于其他列中的数据。

例如，如果您更新与多属性相关的列（例如 SKU 或 Weight value (grams)），则这些列中的数据取决于相应多属性的数据。在这种情况下，您还必须包含 Option1 name 和 Option1 value 列。

国际 CSV 列

如果您已在商店中设置了市场，则您的 CSV 导出将反映您创建的独特市场。默认情况下，您的 CSV 文件包含以下列：

  • Included / [Primary]，其中 [Primary] 会替换为您的主要市场的名称
  • 包含/国际
  • Price / International
  • 原价/国际

如果您将国际市场替换为您自己的市场，则标头名称中的 International 将更改为该市场的名称。

例如，如果您为每个大洲创建了一个市场，并且您的一个市场名称是 South America，则 CSV 导出文件中的列标题将按如下方式进行调整：

  • 包含/国际变为包含/南美
  • Price / International 变为 Price / South America
  • Compare-at price / International 变为 Compare-at price / South America

CSV 列中的元字段

产品元字段支持使用 CSV 文件进行批量导入/导出。定义产品元字段后，它会包含在您的产品 CSV 导出文件中。列标头格式为：<name> (product.metafields.<namespace>.<key>)。您也可以使用 product.metafields.<namespace>.<key>。例如，Fabric 元字段的格式如下：Fabric (product.metafields.shopify.fabric)，或者，不包含名称和括号，即 product.metafields.shopify.fabric。您可以在设置 > 自定义数据 > 产品 > 元字段中找到元字段的命名空间和密钥。详细了解产品元字段。

产品 CSV 导入/导出也支持选项值。使用 Option LinkedTo 列将选项连接到元字段。然后，您可以在相应的 Option values 列中使用元对象值。

多属性元字段

多属性元字段不支持产品 CSV 导入/导出。若要批量编辑多属性元字段，您需要使用多属性批量编辑器，然后添加元字段列。详细了解如何批量编辑多属性详细信息。

产品 CSV 文件中的列说明

下表概述了产品 CSV 文件中所有可能的列。

除了 Title 列，其他一些列也必须有值。必需的列在下表中注明。如果这些列留空或在 CSV 文件中被省略，则系统将创建默认值。

产品 CSV 文件的列

产品 CSV 文件中必须有值的必需列，以及在未提供任何值时自动创建的默认值。
列描述（包括空单元格的默认行为）
Title要向客户显示的产品名称。例如， Women's Snowboard。
URL handle每个产品的唯一识别码。该名称用于产品页面的 URL，并且基于“ Title ”列中的值。例如，如果“ Title ”列中的值为“ Black Sunglasses”，则“ URL handle ”列中的值为“ black-sunglasses ，此为默认设置。如果您希望产品页面 URL 与产品名称不同，可以自定义 URL 标识符的值。

有效的 URL 标识符可以包含字母、短划线和数字，但不能包含任何空格。
Description产品的描述，其中提供有关产品的详细信息。
Vendor您销售的产品的发货地或来源的名称。如果您自己制作产品，则厂商列的值应与您登录 Shopify 时使用的商店名称相同。

了解如何管理厂商信息。

Product category

一个描述产品类型的标签，用于计算其在美国的税率。该标签必须选自 Shopify 的标准产品分类法。

有效的标准化产品类别可通过以下方式识别：

  • 完整的产品类别页面路径，例如 Home & Garden > Linens & Bedding > Bedding > Bed Sheets
  • 类别 ID，例如 hg-15-1-2
Type

如果您除了需要 Shopify 的标准类别之外，还需要自定义类别来整理您的产品，则此标签可用于描述产品。例如，如果产品类别是 Bed Sheets，则有帮助的产品类型可以是 Cooling sheets。此标签不需要遵循任何预定义格式。

详细了解如何添加 产品类型。

Tags

添加关键字以帮助客户在线查找您的产品，或对产品进行分组和筛选：

  • 使用字母、数字和连字符
  • 在同一单元格中，使用逗号分隔标记。例如， Fall-2023, casual, vintage
  • 为每个产品最多添加 250 个标记
  • 避免使用重音字符和符号

大多数电子表格应用会自动为您在标记前后添加引号。如果您使用纯文本编辑器，则需要手动添加引号。例如， tag1, tag2, tag3。

详细了解标记格式。

Published on online store

指明是否应在您的在线商店销售渠道上发布产品。有效值包括：

  • true （默认）：导入的产品在在线商店中可见并且可以销售
  • false：导入的产品不会在在线商店中显示

详细了解如何发布到在线商店。

Status

指示产品是否可供客户购买。如果存在此列，则它需要一个值。如果此列不存在，则产品状态将自动上传为 active。有效值为：

  • active （默认）：产品已准备好销售
  • draft：产品尚未准备好销售
  • archived：产品不再可供销售

详细了解产品状态。

SKU

多属性的货号 (SKU)，用于跟踪库存。如果您使用自定义发货服务，则 SKU 列不能为空。

Barcode

多属性的条码、国际标准书号 (ISBN) 或通用产品代码 (UPC)。

详细了解库存代码。

Option1 name

对于具有多种选项（例如尺寸或颜色）的产品，请输入其名称来创建多属性。产品的每个选项名称值组合都可以是该产品的一个多属性，例如 Size 或 Color。

一个产品最多可以有 3 个选项。

如果产品只有一个选项，则此值应为 Default Title。

详细了解如何创建多属性。

Option1 value

如果产品具有多种选项（例如尺寸或颜色），请输入其值。例如，颜色选项的值可以是 Black。一个产品最多可以有 3 个选项。

如果使用 LinkedTo 列链接到类别元字段，则选项值可以是元对象名称或 GID（而不是显示名称）。

注意：更改此列中的数据会删除现有“多属性 ID”的值并创建新的“多属性 ID”。对“多属性 ID”值的任何更改都可能会破坏第三方对“多属性 ID”的依赖关系。

详细了解如何创建产品多属性。

Option1 LinkedTo如果产品选项已关联到类别元字段，则此值应为 product.metafields.shopify.{taxonomy_attribute}
Price

产品或多属性的价格。仅包括货币值，不带货币符号。例如， 9.99。默认值为 0.00 （如果未输入任何值）。

详细了解产品价格。

Price / International

该产品在同名市场中以该市场货币表示的固定价格。

详细了解适用于国际业务的 CSV 列。

Compare-at price

如果价格已降低并且您想显示价格对比，则为多属性的原价。仅包括货币值，不带货币符号。例如， 9.99。

详细了解如何设置原价。

Compare-at price / International

为该产品在同名市场中以该市场的货币设置固定的原价。要在市场中为产品使用固定原价，则需要为该产品设置固定价格。

详细了解适用于国际业务的 CSV 列。

Cost per item

您制作或获取产品或多属性的成本。仅包含货币值，不含货币符号。例如 9.99。

详细了解如何设置每件商品的成本。

Charge tax

如果产品应税，请设置基于地点的税费。有效值为：

  • true （默认）：您想对产品或多属性收取税款
  • false：您不想对产品或多属性收取税款
Inventory tracker

指明您要使用哪项服务来跟踪多属性库存。有效值包括：

  • shopify
  • shipwire
  • amazon_marketplace_web
  • 空白（如果不跟踪库存）

如果删除了现有库存跟踪选项，则不再跟踪库存。

第三方发货服务：对于在第三方 发货服务 储备库存的多属性，导出的 CSV 会在此列中显示 shopify ；如果启用了库存跟踪，此列将显示该内容，如果未启用库存跟踪，此列将留空。您的库存水平和地点分配将保持不变。若要管理特定发货服务地点的库存，请使用 库存 CSV 文件。或者，如果您有合作的开发人员，也可以使用 Inventory API。

Inventory quantity

您可供销售的产品或多属性的商品数量。这仅适用于具有单个地点的 Shopify 商店。

默认值为 0 （如果未输入任何值）。

详细了解如何管理可用库存。

Continue selling when out of stock

指明是否要让客户购买缺货商品。有效值包括：

  • deny （默认）：您不允许在多属性的库存水平达到 0 后购买它。
  • continue：您允许在多属性的库存水平达到 0 后购买它，这随后会显示负库存水平。

详细了解如何销售缺货产品。

Weight value (grams)

产品或多属性的重量，以克为单位。

您应仅指定数值，而不包含计量单位或小数。例如，如果您的多属性重量为： 5.125 千克，请输入 5125。 4 磅，请输入 1814。

默认值为 0 （如果未输入任何值）。

如果您使用承运商计算的运费或第三方发货服务，请使用准确的重量。

Weight unit for display

您希望在商店中显示产品重量所用的计量单位。

有效值为：

  • g
  • kg （默认）
  • lb
  • oz
Requires shipping

指示产品是否为实体产品（例如，而不是数字产品），因此必须发货。有效值为：

  • true （默认）：需要发货
  • false：不需要发货

详细了解发货详细信息。

Fulfillment service

您用于产品或多属性的发货服务。有效值为：

  • manual （默认）
  • shipwire
  • webgistix
  • amazon_marketplace_web

如果您使用自定义发货服务，请按照以下指南在此列中输入服务名称：

  • 仅使用小写字母
  • 将空格替换为短划线 (-)
  • 删除句点和其他特殊字符

例如，如果“Joan's Fulfillment”是您的发货服务的名称，则输入 joans-fulfillment 在 CSV 文件中。

您必须先在 Shopify 后台中设置自定义发货服务，然后才能在此列中添加该服务的名称。

第三方发货服务：对于在第三方 发货服务 储备库存的多属性，导出的 CSV 会在此列中显示 manual 。礼品卡多属性则会显示 gift_card 。您的发货服务分配和地点分配将保持不变。

导入 CSV 时，如果将此列设置为特定的发货服务名称（例如 joans-fulfillment），那么将激活该多属性在该发货服务地点的库存。该多属性已有库存的任何其他地点均会保持原状，不会取消任何地点的库存。导入后，在重新导出时，此列将继续针对这些多属性显示 manual 。若要直接管理特定发货服务地点的库存，请导入 库存 CSV 文件。或者，如果您有合作的开发人员，也可以使用 Inventory API。

Included / [Primary]

如果您进行国际销售，则此列指示是否将产品包含在您的主要市场中进行销售。默认值为 true。

此列标题名称因在国际中确定为您的主要市场的国家/地区而异。如果您更改默认的主要市场，则列标头将显示为新的市场名称。请参阅注意事项部分了解详细信息。

Included / International

如果您进行国际销售，则此列指示产品是否可以在您的国际市场中销售。默认值为 true。

此列标题名称因您在商店中设置的国际业务而异。默认市场是 International。如果您更改默认市场或添加任何新市场，则列标头将显示这些市场名称。请参阅注意事项部分了解详细信息。

Product image URL

输入产品图片的 URL。Shopify 会在导入过程中下载图片，然后将它们重新上传到您的商店。

请确保图片文件名：

  • 是最终名称：图片上传到您的商店后，您便无法对其进行编辑
  • 不包括 _thumb、 _small或 _medium 后缀

此列不特定于多属性。使用多属性图片列添加多属性图片。

Image position

输入表示您希望图片在产品页面上显示顺序的数字。图片按升序显示，从图片位置值 1 开始。例如，如果您希望图片在该产品中首先显示，则输入 1。

Image alt text

替代 (alt) 文本用于描述图片及其代表的产品。如果图片因任何原因无法在浏览器中加载，则会显示替代文本。辅助技术也会使用它来向使用屏幕阅读器等工具的视障客户描述图片。添加替代文本可以提升您网站的 SEO。

请保持您的替代文本简短且具有描述性：

  • 最大长度为 512 个字符
  • 最佳长度为 125 个字符或更少
Variant image URL

输入多属性图片的 URL。请确保添加的 URL 是正常工作的图片 URL。

Gift card

指示产品是否为礼品卡。有效值为：

  • false （默认）：该产品不是礼品卡
  • true：产品是礼品卡

此列还允许您批量编辑其他礼品卡详细信息，例如 Description 或 Tags，但您无法通过导入产品 CSV 文件来创建礼品卡。礼品卡只能在 Shopify 后台中创建和激活。

SEO title

显示在搜索引擎结果中的产品名称。您输入的 SEO 标题可以是字母数字，最多可包含 70 个字符。有效的 SEO 标题为：

  • 字母数字
  • 最多 70 个字符

如果您将此列留空，则产品 Title 将用作产品的搜索引擎产品页面标题。

详细了解编辑 SEO 标题。

SEO description

SEO 描述也位于产品详细信息页面的搜索引擎列表预览标头中的描述中。您输入的 SEO 描述可以是字母数字，最多可包含 320 个字符。

如果您将此列留空，则产品 Description 将被使用。

Google Shopping / Google Product Category

如果您当前使用 Google 产品类别，则可以将其用作您的 Shopify 产品类别。您可以使用产品类别、Google 产品类别或两者。为每个商品提供尽可能具体的类别。

Google 产品类别 (GPC) (google_product_category) 使用 Google 的产品分类。

您可以通过以下任一方式输入 Google 产品类别：

  • 使用完整的类别页面路径，例如 Apparel & Accessories > Clothing > Clothing Tops > Shirts
  • 使用类别 ID，例如 212
Google Shopping (Unstructured metafield)

列标头将根据所含值代表的 Google 购物元字段而有所不同，并且前面会加上 Google Shopping / 。产品 CSV 列标头中包含的元字段包括：

  • Gender
  • Age Group
  • MPN
  • Condition
  • Custom Product
  • Custom Label 0
  • Custom Label 1
  • Custom Label 2
  • Custom Label 3
  • Custom Label 4

Google 购物列可供应用用于将产品同步到 Google Merchant Center。但是，Google 和 YouTube 渠道不使用这些元字段。除非有应用指示您使用包含“Google 购物”名称的元字段列中的值，否则您可以忽略这些值。

Metafields

这些产品元字段是在您的商店中创建的。产品元字段定义在列标头中显示为 NAME; (product.metafields.custom.KEY)。CSV 批量导入或导出支持以下元字段类型：

  • boolean
  • 颜色（示例： #ff00cc）
  • date
  • date_time
  • 维度（示例： 25.0cm）
  • list.color（示例： #ff00cc; #cc0000）
  • list.date（示例： 2023-12-02; 2023-12-03）
  • list.date_time（示例： 2023-12-02T09:30:00; 2023-12-03T10:00:00）
  • list.dimension（示例： 10.0cm; 3.0m）
  • list.metaobject_reference（示例： gid://shopify/Metaobject/123; gid://shopify/Metaobject/456 或元对象名称，例如 blue; red）
  • list.number_decimal（示例： 1.0; 2.1）
  • list.number_integer（示例： 3; 4）
  • list.product_reference（示例： gid://shopify/Product/123; gid://shopify/Product/456 或产品名称，例如 boots; skis）
  • list.url（示例： http://www.google.com; http://shopify.com）
  • list.volume（示例： 10.0ml; 2.0l）
  • list.weight（示例： 1g; 2.0lb; 3.0 kg）
  • money（示例： 5.99 CAD）
  • multi_line_text_field（示例：
    "Ingredients Flour Water Milk Eggs"）
  • number_decimal（示例： 1.0）
  • number_integer（示例： 1）
  • product_reference（示例： gid://shopify/Product/123 或产品名称，例如 boots）
  • shopify.disclosure（例如 shopify--disclosure-us-ca-prop65-cancer:prop-65-cancer 代表 Shopify 标准产品披露信息，或者 shopify--disclosure-custom:merchant-warning 代表自定义产品披露信息）
  • single_line_text_field（示例： single line）
  • url（示例： http://shopify.com）
  • volume（示例： 10.0ml）
  • weight（示例： 10.0g）

使用导入的 CSV 文件覆盖产品详细信息

导入 CSV 文件时，您可以选择覆盖具有匹配标识符的产品选项。如果选择此选项，则当导入的 CSV 文件中的标识符与产品列表中的现有标识符匹配时，CSV 文件中的值将覆盖现有产品列表中匹配列中的值。如果未选择覆盖选项，则在 CSV 导入期间将忽略与现有标识符匹配的产品。

  • 如果导入的 CSV 文件中的非必需列为空，则产品列表中的匹配值将被覆盖为空。
    • 例如， Vendor 您现有产品列表中的值为 John's Apparel，但 Vendor 列在您导入的 CSV 文件中为空，则 John's Apparel 将被覆盖为空白。
  • 如果导入的 CSV 文件中不包含非必需列，但现有产品列表中包含该列，则产品列表中的值将保持不变。
    • 例如，如果 Variant image URL 列包含在现有产品列表中，但导入的 CSV 文件中不包含该列，则产品列表中的值将保持不变。
  • 如果导入的 CSV 文件中包含依赖于文件中未包含的其他列数据的非必需列，则现有数据将被删除或移除。
    • 例如，如果导入的 CSV 文件中包含 SKU 列，但不包含 Option1 value（选项 1 值）和 Option1 name（选项 1 名称）列，则产品多属性选项将被删除。
  • 无法使用 CSV 文件批量删除产品。如果您想批量删除产品，则可以在后台的产品部分使用批量操作。
  • 无法使用 CSV 文件在其他销售渠道上批量更新产品供货情况。详细了解在其他销售渠道中设置产品供货情况。

Collection 列例外情况

若要在上传 CSV 文件期间将产品整理到产品系列中，您可以在 CSV 文件中的任意位置添加一个新列，并将标头名称设置为 Collection。

当您导出 CSV 文件时， Collection 列不会包括在内。

关于 Collection 列的说明，该列可添加到您的产品 CSV 导入文件中。
列描述
Collection

输入您想将此产品添加到的产品系列的名称。

  • 如果是现有的自动产品系列，则产品需要满足该产品系列的条件。
  • 如果该产品系列尚不存在，则将创建一个手动产品系列。

您只能将一个产品添加到一个产品系列。

此值可以为空。

最大长度为 255 个字符。

详细了解覆盖现有产品如何影响此列中的数据。

创建您的产品 CSV 文件

对于每个产品，您都需要确定它是简单产品还是带有多属性的产品：

  • 简单产品：简单产品不包含多属性。如果您上传没有多属性的产品，请在第一行中输入该产品的所有字段以及第一张图片的 URL。在后续行中，仅输入每张其他图片的标识符和 URL。
  • 带有多属性的产品：如果您上传带有多属性的产品，请在第一行中输入该产品的所有字段以及第一张图片的 URL。在后续行中，输入 URL 标识符。然后跳过 Title、 Description、 Vendor、 Tags 列。填写其余多属性的详细信息和每张图片的 URL。

添加完所有产品和图片后，请使用 LF 样式的换行符以 UTF-8 格式保存您的 CSV 文件。如果您不熟悉编码，请查看您的电子表格或文本编辑器程序的文档。

要查看 CSV 文件示例，请下载此产品 CSV 示例文件，然后用 Google 表格或其他电子表格程序打开它。

准备您的图片

CSV 文件只能包含文本，因此，您需要确保所有产品图片都位于现有网站上。这些图片 URL 仅在 CSV 文件导入过程中使用。您可以在导入完成后删除这些 URL。

您只能在 CSV 文件中使用图片 URL。CSV 不支持 3D 模型和视频，但您可以将它们上传到内容 > 文件。详细了解产品媒体文件类型。

来自外部来源的图片 URL 需要可公开访问。将图片上传到内容 > 文件有助于确保您的所有产品图片都准确无误。

根据图片文件的位置，执行以下操作之一：

  • 如果文件仅在您的计算机上，则您必须将它们上传到 Shopify 商店的内容 > 文件中，或上传到其他图片托管服务（例如 GoDaddy、OneDrive、Dropbox 或 BucketLynx），然后获取其 URL。
  • 如果您要从其他平台切换到 Shopify，则可以复制当前的图片 URL 并在 CSV 文件中使用它们。
  • 如果产品 CSV 文件是通过从 Shopify 导出您的产品而生成的，那么您无需执行任何操作，因为您的图片已在您的网站上。

在您拥有每个产品图片的 URL 后，即可开始构建 CSV 文件。

在 CSV 文件中添加多个产品图片

您可以通过将更多图片上传到 Shopify 后台，将更多产品图片添加到 CSV 文件中。如果您使用 CSV 文件来构建 Shopify 商店，则流程会略有不同。请查看以下注意事项：

  • 您需要能够编辑 CSV 文件。Shopify 建议使用 Google 表格来查看 CSV 文件的格式化版本。
  • 您最多可以为一款产品添加 250 张图片。
  • 您的产品图片必须上传到可公开访问的 URL。也就是说，它们应采用 https:// 协议，并且没有密码保护。为此，您可以将图片上传到 Shopify 后台的文件页面。URL 会自动生成。点击上传文件后，您最多可以选择几百张图片进行批量上传。

将多张产品图片添加到 CSV 文件

  1. 插入新行。每张图片必须只使用一行。
  2. 复制并粘贴标识符。
  3. 复制并粘贴图片 URL。

插入新行

  1. 在您的电子表格程序（例如 Google 表格）中打开您的 CSV 文件。
  2. 找到您要向其添加图片的产品。
  3. 在下一行中，点击并拖动行号以选择多个行。选择与您添加的其他图片数量相同的行数。
    在产品 CSV Google 电子表格中，第三行和第四行已突出显示。
  4. 在突出显示这些行的情况下，右键点击突出显示区域中的任意位置，然后选择 在上方插入 X 行。
    在产品 CSV Google 电子表格中，已选择“在上方插入 2 行”选项。

复制并粘贴 URL 标识符值

将所需产品的 URL 标识符值复制并粘贴到新行的 A 列中。

在产品 CSV Google 电子表格中，文本 black-shirt 已在第三行和第四行的“名称”列下输入。

复制并粘贴图片 URL

  1. 在文件页面上，将您的图片上传到 Shopify。
  2. 点击 复制链接 图标一次获取一个图片 URL。
    在 Shopify 后台“文件”页面中，黑色 T 恤图片所在行中的链接按钮突出显示。
  3. 在电子表格应用程序的 CSV 文件中，横向滚动到 CSV 文件的最后几列。
  4. 在 Product image URL 列中，将图片 URL 粘贴到每一行。
    在产品 CSV Google 电子表格中，黑色 T 恤产品图片 URL 被输入到 Image Src 列的一行中。
  5. 对此产品的所有图片重复执行第 2 步到第 4 步
  6. 可选：若要改进您的 SEO，请为所有 Image alt text 字段输入值。详细了解图片 alt 文本。
  7. 保存 CSV 文件并将其导入 Shopify。