Shopify section 设置了 max_blocks 却不生效
现象#
schema 里写了 max_blocks: 3,编辑器仍能继续添加第 4、第 5 个区块。
原因#
max_blocks写在了 block 的定义里,而不是 section schema 顶层- JSON 模板被手工塞入了超过上限的 block,编辑器读取时不会自动裁剪
- 同时声明了
@app类型 block,应用区块不受该上限约束,看起来像没生效 - 主题版本较旧,对 max_blocks 的支持与当前编辑器不一致
处理步骤#
- 把
max_blocks移到 schema 顶层,与blocks同级 - 打开对应
templates/*.json,删掉超量的 block 配置后再进编辑器 - 需要限制应用区块时,改用
max_blocks配合block_order校验,或在前台做数量兜底 - 用
shopify theme check验证 schema,避免字段被静默忽略
验收标准#
达到上限后「添加区块」按钮不可用;已有模板中不再出现超出上限的区块。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。