以下详细说明为英文。
此预设检查的内容
每个文件都会执行 48 项检查,每项都链接到包含示例和修复方法的指南。
- 缺少必填列自动修复
您的 CSV 缺少 Shopify 必填的列标题。
- 缺少 Title
至少有一行的 Title 为空。
- 缺少 URL handle自动修复
至少有一行的 URL handle 为空。
- URL handle 无效自动修复
URL handle 包含 Shopify 可能拒绝的字符。
- Published 值无效自动修复
Published on online store 的值不是布尔值。
- Status 值无效自动修复
Status 不是 Active、Draft 或 Archived。
- 选项列顺序错误
Option1 为空,但 Option2/Option3 有值。
- 变体缺少 Option1 value
这一行看起来是变体数据,但 Option1 value 为空。
- Price 无效
Price 不是有效数字。
- Compare-at price 无效
Compare-at price 不是有效数字。
- 库存数量无效
Inventory quantity 不是有效整数。
- 库存策略无效自动修复
Continue selling when out of stock 不是 DENY/CONTINUE。
- 缺少 Status自动修复
存在 Status 列,但商品行没有值。
- Charge tax 无效自动修复
Charge tax 不是 true 或 false。
- Requires shipping 无效自动修复
Requires shipping 不是 true 或 false。
- Gift card 无效自动修复
Gift card 不是 true 或 false。
- Cost per item 无效
Cost per item 不是有效数字。
- 重量无效
Weight value (grams) 不是整数克数。
- 重量单位无效自动修复
Weight unit for display 不是 g、kg、lb 或 oz。
- 库存跟踪设置无效自动修复
Inventory tracker 中有 Shopify 无法识别的值。
- 发货服务无效自动修复
Fulfillment service 不是有效的服务 handle。
- 包装尺寸不完整
包装的长、宽、高和单位只填写了一部分。
- 标签过多
某个商品的标签超过 250 个。
- 图片位置无效
Image position 不是有效整数。
- 已生成 URL handle
文件中没有 URL handle 列,因此已根据每个 Title 生成 handle。
- URL handle 已更改
某个 URL handle 包含 Shopify 不允许的字符,已被改写。
- 有选项名称但没有值
填写了选项名称,但对应的选项值为空。
- 变体之间的选项名称不一致
共用同一 handle 的行,Option1/2/3 的名称应保持一致。
- 变体选项不唯一
同一 handle 下有两个或更多变体的选项值完全相同。
- "Default Title" 与真实选项混用
同一 handle 下同时存在 "Default Title" 行和带选项的变体行。
- 变体信息相同的重复行
有些行共用同一 handle,看起来是重复行而不是真正的变体。
- 同一 handle 的 Title 不同
共用同一 URL handle 的行使用了多个不同的 Title。
- 缺少 Price
某个变体行的 Price 为空。
- Compare-at price 低于 Price
Compare-at price 低于 Price。
- 负库存
Inventory quantity 为负数。
- 图片网址无效
商品图片网址不是有效的 http(s) 网址。
- 图片行包含变体字段
某行看起来是纯图片行,却包含 SKU/Price/Options/Inventory 字段。
- 图片位置重复
同一 handle 下有两行的 Image position 相同。
- 替代文本过长
图片替代文本超过了 Shopify 建议的上限。
- SKU 重复
同一个 SKU 出现在多个变体行中。
- 不同商品间 SKU 重复
同一个 SKU 出现在不同的 URL handle(不同商品)下。
- SEO 标题过长
SEO 标题超过了建议长度。
- SEO 描述过长
SEO 描述超过了建议长度。
- 缺少 SEO 标题
SEO 标题为空(Shopify 将改用 Title)。
- 缺少 SEO 描述
SEO 描述为空(Shopify 将改用 Description)。
- 图片网址使用了 http
某个图片网址以 http:// 而不是 https:// 开头。
- CSV 中有礼品卡
有一行被标记为礼品卡。
- Product category 看起来像 Google ID
Product category 只有数字,类似 Google 商品类目 ID。
预期列
示例行
| Title | URL handle | Description | Vendor | Product category | Type | Tags | Published on online store | Status | SKU | Barcode | Option1 name |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Sample Product | sample-product | A short description for your product. | Your Brand | Apparel & Accessories > Clothing | T-Shirt | sample, tshirt, cotton | TRUE | active | SKU-1001 | Title |
为了可读性显示12列。下载示例CSV以获取完整的标题集。
关于此格式
Shopify 的商品导入要求很严格:一个格式错误的价格、一个缺失的选项值,或者一行放错位置的图片,都可能导致整个导入失败。
此预设会根据 Shopify 官方模板校验您的 CSV,并应用安全的自动修复,让您可以放心上传。数据始终由您掌控:每项修复都有记录,导出的 CSV 仍可直接导入 Shopify。
工作原理
- 1上传您从 Shopify 导出的 CSV 或官方模板。
- 2我们会规范表头和常见格式(布尔值、金额、库存值),并校验必填字段。
- 3自动修复安全的问题(例如去除空格、统一 TRUE/FALSE、规范价格字段),并标出有风险的问题供您检查。
- 4导出一份符合 Shopify 预期结构的干净 CSV。
修复示例
- 统一布尔值(TRUE/FALSE)和状态值(active/draft/archived)。
- 规范金额字段(Price、Compare-at price、Cost per item),并去除多余的货币符号。
- 检测会导致导入失败的重复 SKU 和变体冲突。
- 校验选项结构(Option1/2/3 的名称/值),并标出不完整的变体行。
- 校验图片行(Product image URL、Image position),并标出缺失或无效的网址。
- 清理并规范空格、标签和 handle 格式,保持一致。
常见问题
这会更改我的商品数据吗?
能处理其他应用导出的文件吗?
可以使用 Shopify 官方模板吗?
热门CSV指南
针对最常见CSV导入问题的逐步指南。
了解如何在 Shopify 商品 CSV 中组织图片网址:Image Src、Image Position 和 Image Alt Text 列,如何为一个商品添加多张图片,以及如何避免最常见的图片导入失败。
关于 Shopify 商品 CSV 中 Handle 字段的一切:它的作用、有效 handle 的规则、如何对变体分组,以及如何修复 handle 错误。
最常见的 Shopify CSV 导入错误完整指南:缺少列、布尔值无效、变体结构问题、价格错误和 handle 冲突。
逐列讲解 Shopify 官方商品 CSV 模板中的每个字段:每列的作用、可接受的值以及哪些是必填项。
了解 Shopify 的 CSV 格式如何通过 Handle 分组、Option 列和父/子行来表示商品变体,避免导致商品被拆分、变体丢失和导入失败的常见错误。
了解追加行、合并结构相同的文件以及连接含关联数据的文件之间的区别,为您的电商目录工作流程选择合适的方法。