shopify产品导入 CSV 文件中各字段的含义 Shopify 商品自动上架

Qoo10.ai

shopify产品导入 CSV 文件中各字段的含义 Shopify 商品自动上架

使用 CSV 文件

您可以使用 CSV（以逗号分隔的值）文件将产品导入 Shopify 商店，以及从商店导出产品。您可以通过使用 CSV 文件，一次导入或导出大量产品及其详细信息。如果您想在 Shopify 和其他系统之间交换产品信息，这是种非常有用的方法。


获取示例 CSV 文件

您可以下载和查看要用作模板的示例产品 CSV 文件。

    示例文件包含一个示例产品和几个多属性。导入文件可能包含更多产品和多属性。如果您使用示例文件来创建自己的导入文件，请确保删除所有示例产品。

    示例文件包含 Variant Inventory Qty 列，仅用于拥有单个地点的商店。如果您使用多个地点并想要导入或导出库存数量，请使用库存 CSV 文件。

产品 CSV 文件格式

产品 CSV 文件的第一行必须是示例 CSV 文件中所含的列标题，并采用与列标题相同的顺序。每列必须以逗号分隔。文件中的以下行（或记录）必须包含产品数据，这些数据按照完全相同的顺序使用相同的列。
备注

如果您使用 Excel 编辑 CSV，请在导出 CSV 时检查 Excel 的导出设置，以确保文件中的各个值之间用逗号分隔。

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

导入 CSV 文件时，您可以选择选项覆盖具有相同 handle 的任何现有产品。现有的值将用于任何缺少的列。如果选择此选项，则当导入 CSV 文件中的 handle 与产品列表中的现有 handle 匹配时，CSV 文件中的值会覆盖现有产品列表内匹配列中的值。如果未选择覆盖选项，则在 CSV 导入期间，与现有 handle 匹配的产品将被忽略。

    如果导入 CSV 文件中的必填列为空，则产品列表中的匹配值将被覆盖为空。

    例如，假设现有产品列表中的 Type 值为 Snowboard，但导入的 CSV 文件中的 Type 列为空，则 Snowboard 将被覆盖为空。

    如果导入 CSV 文件中不包含非必填列，但现有产品列表中包含此类列，则产品列表中的值将保持不变。

    例如，如果现有产品列表中包含 Variant Image 列，但导入 CSV 文件中不包含该列，则产品列表中的值将保持不变。

注意

更改产品 CSV 文件的 Option1 Value、Option2 Value 或 Option3 Value 列中的数据会导致现有多属性 ID 被删除并创建新的多属性 ID。对多属性 ID 值的任何更改都可能会破坏多属性 ID 的第三方依赖项。


产品导入 CSV 文件的描述
[td]        

列	描述	数据要求
Handle	名称是每种产品的唯一名称。它们可以包含字母、短划线和数字，但不能包含空格、重音符号或其他字符，包括句点。每个产品的 URL 中都会使用名称。                 例如，“女用滑雪板”的名称应为 womens-snowboard，且产品的 URL 应为 https://yourstore.myshopify.com/products/womens-snowboard。                 CSV 文件中以不同名称开头的每行都被视为一个新产品。若要向产品添加多张图片，您必须添加具有相同名称的多行。	必填。不能为空或缺失。
Title	产品的标题。例如，女用滑雪板。	必填。不能为空或缺失。
Body (HTML)	HTML 格式的产品描述。也可以使用没有任何格式的纯文本。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Vendor	产品供应商的名称。例如，John 的服装店。	必填，但可以为空。         输入的值的长度必须至少为两个字符。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Type	产品类型。例如，滑雪板。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Tags	用于标记产品的以逗号分隔的标签列表。大多数电子表格应用程序都会自动为标签添加引号。如果您使用的是纯文本编辑器，则需要手动添加引号。例如，“标签1, 标签2, 标签3”。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Published	指示产品是否已发布在您的在线商店上。有效值为 TRUE（即产品已发布在您的在线商店上）或 FALSE（即产品已对您的在线商店隐藏）。	必填。将此字段留空则发布产品。
Option1 Name	如果某个产品有选项，请输入选项名称。例如，颜色。	必填。不能为空或缺失。 对于只有一个选项的产品，此字段应设置为 Title。
Option1 Value	注意：更改此列中的数据会导致现有多属性 ID 值被删除并创建新的多属性 ID。对多属性 ID 值的任何更改都可能会破坏多属性 ID 的第三方依赖项。                 如果某个产品有选项，请输入选项值。例如，黑色。	必填。不能为空或缺失。         对于只有一个选项的产品，此字段应设置为 Default Title。
Option2 名称	如果某个产品有第二个选项，请输入其名称。例如，尺寸。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Option2 值	注意：更改此列中的数据会导致现有多属性 ID 值被删除并创建新的多属性 ID。对多属性 ID 值的任何更改都可能会破坏多属性 ID 的第三方依赖项。                 如果某个产品有第二个选项，请输入选项值。例如，大号。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Option3 名称	如果某个产品有第三个选项，请输入选项名称。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Option3 值	注意：更改此列中的数据会导致现有多属性 ID 值被删除并创建新的多属性 ID。对多属性 ID 值的任何更改都可能会破坏多属性 ID 的第三方依赖项。                 如果某个产品有第三个选项，请输入选项值。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
多属性 SKU	产品或多属性的 SKU。这用于使用库存更新服务更新库存。                 如果您使用的是自定义发货服务，此字段则不能留空。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Variant Grams	产品或多属性的重量，以克为单位。请勿指定计量单位或使用小数。例如，如果重量为 5.125 kg，请输入 5125。                 即使您指定了不同的单位，Shopify 也始终以克为单位导入和导出重量。如果您打算提供承运商自动计算运费或使用第三方发货服务，您必须使用准确的重量。	必填。不能为空或缺失。         您必须输入一个值，即使该值为 0。
Variant Inventory Tracker	包括此多属性或产品的库存跟踪。如果未跟踪库存，有效值包括则 shopify、shipwire、amazon_marketplace_web 或为空。	必填，但可以为空。         如果删除现有库存跟踪选项，则不会再跟踪库存。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Variant Inventory Qty	此产品或多属性的有库存商品数。此列仅用于具有单个地点的 Shopify 商店。                 如果您的商店管理多个地点的库存，则不包括此列。如果要导入或导出库存数量，请使用库存 CSV 文件。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Variant Inventory Policy	当此产品或多属性的库存水平为零时如何处理订单。有 deny 库存政策的多属性在其库存水平达到零后就无法购买。有 continue 库存政策的多属性可以在其库存水平达到零后购买，从而允许库存水平为负数。	必填。不能为空或缺失。
Variant Fulfillment Service	使用的产品或多属性发货服务。有效值包括：manual、shipwire、webgistix、amazon_marketplace_web。                 如果您使用自定义发货平台，则可以在此列中添加服务名称。对于自定义名称，仅使用小写字母。不允许使用空格 — 请用短划线 (-) 替换它们。句点和其他特殊字符将被删除。例如，如果“Joan's Fulfillment”是您发货服务的名称，请在 CSV 文件中输入 joans-fulfillment。                 您必须先在 Shopify 后台设置自定义发货服务，然后才能在此列中添加服务名称。	必填。不能为空或缺失。
Variant Price	产品或多属性的价格。请勿包含任何货币符号，仅包含价格。例如 9.99。	必填。不能为空或缺失。
Variant Compare at Price	产品或多属性的“原价”。请勿包含任何货币符号，仅包含价格。例如 9.99。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Variant Requires Shipping	要求发货的选项。有效值为 TRUE、FALSE 或为空（等效于 FALSE）。	必填，但可以为空。
Variant Taxable	将税费应用于此多属性。有效值为 TRUE、FALSE 或为空（等效于 FALSE）。	必填，但可以为空。
Variant Barcode	产品的条码、ISBN 或 UPC。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Image Src	输入产品图片的 URL。Shopify 会在导入过程中下载图片，并将它们重新上传到您的商店。这些图片不是特定于多属性的。多属性图片列是指定多属性图片的位置。                 您将图片上传到您的商店后，便无法更改图片文件名。请勿上传其名称中包含 _thumb、_small 或 _medium 后缀的图片。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Image Position	输入表示要在产品页面上显示图片的顺序的数字。图片将按从小到大的顺序显示，从图片位置值 1 开始。例如，输入 1。如果您希望从该产品开始显示图片。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Image Alt Text	替代文本对图片进行描述，是产品描述的一个重要组成部分。如果出于任何原因图片无法加载，则会改为显示替代文本。辅助技术还会使用替代文本向存在视觉障碍的客户描述图片的内容。包含替代文字将提升网站的 SEO。保持替代文本的简洁和描述性。最大长度为 512 个字符，但最佳长度是不超过 125 个字符。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Gift Card	说明产品是否是礼品卡。有效值为 TRUE 或 FALSE。添加此列还允许您编辑其他礼品卡详细信息（例如“正文”或“标签”列），并导入这些更改。只能在 Shopify 后台创建和激活礼品卡。您最初无法通过产品 CSV 文件导入创建礼品卡。	必填，但可以为空。         详细了解覆盖现有产品如何对此列中的数据产生影响。
SEO Title	SEO 标题位于页面标题字段中搜索引擎优化标头下的产品详细信息页面上。SEO 标题的字符（字母和数字）限制为 70 个字符。如果在导入产品时将此字段留空，系统便会使用产品名称自动填充该字段。	可选。         详细了解覆盖现有产品如何对此列中的数据产生影响。
SEO Description	SEO 描述也可以在元描述字段中搜索引擎优化标头下的产品详细信息页面上找到。SEO 描述的字符（字母和数字）限制为 320 个。如果在导入产品时将此字段留空，系统便会使用产品描述自动填充该字段。	可选。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Google 购物 元字段	应用可能会使用 Google 购物字段将产品同步到 Google Merchant Center。但是，Shopify 的 Google 渠道不会使用这些元字段。您可忽略其名称中包含 Google 购物的列中的字段，除非应用告诉您使用它们。	可选。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Variant Image	多属性图片的 URL。如果添加 URL，必须添加有效的图片 URL。	可选。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Variant Weight Unit	有效值为 g、kg、lb 和 oz。	可选。         如果将此字段留空，则 Variant Weight Unit 将为 kg。
Variant Tax Code	可用于： Shopify Plus 套餐                 对此产品征税的 Avalara 代码。仅当您从使用 Shopify Plus 套餐与 Avalara AvaTax 集成的商店中导入或导出时，此字段才适用。                 当您通过从使用 Avalara 的商店导入产品来创建 CSV 文件时，会填充 Variant Tax Code（多属性税码）字段。如果您将此 CSV 文件导入未设置有 Avalara 的商店中，导入则将失败。	可选。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Cost per item	产品或多属性的成本。请勿包含任何货币符号，仅包含成本。例如 9.99。	可选。         详细了解覆盖现有产品如何对此列中的数据产生影响。
Status	是否向您的客户提供产品。有效值为：                                   active：产品处于活跃状态，可供销售 draft：产品处于草稿状态，需要在完成后才可销售 archived：产品已隐藏，无法再销售	必填。        如果缺少该列，则所有产品都将以 active 状态上传。如果该列存在但值为空，则上传会失败，并出现以下错误：状态无效。请将状态设置为 active、, draft 或 archived。

在 CSV 文件中添加多个产品图片您可以通过将更多图片上传到 Shopify 后台来将更多的产品图片添加到 CSV 文件。如果要使用 CSV 文件开发 Shopify 商店，那么流程会略有不同。以下是您需要了解的内容：

• 您需要能够编辑 CSV 文件。Shopify 建议使用 Google 表格来查看 CSV 文件的格式化版本。
  
• 您可以为一个产品添加多达 250 张图片。
  
• 您的产品图片必须上传到可公开访问的 URL。也就是说，这些 URL 应以 https:// 协议开头，并且没有密码保护。为了实现这一目标，您可以将图片上传到 Shopify 后台的文件页面。系统会自动生成 URL。单击上传文件后，您可以选择多达一两百张图片进行批量上传。
  
  

若要添加多个图片，您需要执行以下操作：

• 插入新行（每张图片一行）。
• 复制并粘贴“名称”。
• 复制并粘贴图片 URL。
  

插入新行（每张图片一行）

• 在电子表格程序（例如 Google 表格）中打开 CSV 文件。
  
• 找到要向其添加图片的产品。
  
• 在下一行上，单击并拖动行号以选择多行。选择与要添加的额外图片数相同的行数。
  
  
• 当这些行突出显示时，右键单击突出显示区域中的任意位置，然后选择在上方插入 X 行。
  
  
  

此操作将在要向其添加其他图片的产品下方创建三个空行。
复制并粘贴“名称”将所需产品的“handle”复制并粘贴到新行的 A 列。


复制并粘贴图片 URL

• 在文件页面上将您的图片上传至 Shopify
  
• 单击复制链接图标，一次复制一个图片 URL。
  
  
• 返回电子表格软件并横向滚动到 CSV 文件的最后一列。
  
• 在列 "Image Src"（“图片源”的缩写）中，将一个图片 URL 粘贴到每一行中。
  
  
• 对此产品的所有图片重复执行步骤 2 - 4
  
• （可选）：填写下一列“图片替换文本”下的字段以提升您的 SEO。详细了解图片替换文本。
  
  

然后，您可以保存文件并将其导入 Shopify。

Qoo10.ai

Shopify产品表格上传常见错误提示与解决方法 遇见 第一个问题 ：
Illegal quoting on line

可能性除了上面说的引号错误，还有可能是字符编码错误，请查看是否有乱码，为了尽可能的避免错误，表格内容请全部使用英文字符。

Shopify产品表格上传常见错误提示与解决方法
Invalid CSV header: missing headers
这个提示是说表格第一行有错误。请确认表格第一行必须为以下Field Name:
如果Field Name没有错误，请确认Field Name单词后面不能有空格！
Missing or stray quote on line
引号使用错误。请确认使用的是英文字符下的引号””，而不是中文状态下的引号“”。
Illegal quoting on line
可能性除了上面说的引号错误，还有可能是字符编码错误，请查看是否有乱码，为了尽可能的避免错误，表格内容请全部使用英文字符。
Line #-##: validation failed: options are not unique
出现这个错误提示是说，你的表格里面的变体信息有重复内容。例如Color写了两个Red。或者Size写了两个Medium。
Validation failed: getaddrinfo: nodename nor servname provided, or not known
出现这个错误提示通常是因为产品图片的URL地址出现了错误。请确认图片地址以https://开始。另外请确认图片地址为direct url。也就是说图片地址以.jpg或.png等图片格式结尾。
Validation failed: price can’t be blank
价格为必填项，不能为空。请确认所有的价格信息已经完整填写
Inventory quantity can’t be blank
库存数量为必填项，不能为空
Inventory quantity is not a number
库存数量不是一个阿拉伯数字。请确认表格里面的库存数量为阿拉伯数字
Inventory policy is not included in the list
库存跟踪不能为空，为必填项。请选择 ‘deny’ 或者 ‘continue’
Fulfillment service can’t be blank
发货方式不能为空，如果是自发货，需要填写为Manual
Ignored line #-## because handle example already exists
表格里面的handle一列，不同的产品必须不能重复。如果出现重复，则会出现如上错误提示。
Line #: incorrect header check
将提示的错误行的图片URL删除掉之后重新上传表格，看看还有没有错误提示
Ignored line #-## because it did not contain product data
出现上面错误提示，表示该行有handle信息但是缺少Title信息