Shopify section schema 设置类型写错导致保存失败
现象#
改完 section 的 schema 后在编辑器点保存,提示设置无效或整段设置项消失,控制台报 schema 校验错误。
原因#
type用了不存在的类型,如text_area、color_pickerrange类型的min/max/step不是数字或缺失select的options写成了字符串数组而不是{value,label}对象- 同一个 section 里
id重复,或 id 里带了大写字母与短横线以外的字符
处理步骤#
- 对照官方 schema 文档逐个核对类型名:
text、textarea、richtext、range、select、color、image_picker、url、checkbox select的 options 改成[{'value':'a','label':'选项 A'}]range补齐三个数值字段,step不要写成字符串- 跑
shopify theme check,ValidSchema 规则会直接指出行号 - 改完先
shopify theme push --only sections/xxx.liquid单文件推送,避免整站覆盖
验收标准#
编辑器能正常保存,设置项全部显示且拖动/选择后前台有响应,theme check 无 ValidSchema 报错。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。