section 预设里配了 blocks 添加出来却是空的
现象#
在 presets 中写了三个 slide 区块,商家从「添加 section」插入后侧栏一个区块都没有,还得手动再加。
原因#
- presets 里 blocks 的 type 必须是 schema 声明过的类型,写错时整条预设被丢弃
- 预设区块数超过
max_blocks时超出部分被截断,看起来像没生效 - presets 中不能写 block id,即使写了也被忽略,区块仍按生成顺序编号
- section 完全没有 presets 时只能手工写进 JSON,编辑器不提供添加入口
处理步骤#
- 核对
presets[].blocks[].type与 schema 中声明的 type 是否逐字一致 - 把预设区块数量控制在
max_blocks以内,例如上限 3 时就只放 3 条 - 预置文案放进每条 block 的
settings,不要依赖外层 section 设置 - 保存后在编辑器删掉该 section 再重新添加,观察侧栏是否直接出现区块
- 仍为空时把 presets 内容手工写进
index.json,验证这些 type 能否渲染
验收标准#
从「添加 section」插入后侧栏立即列出预设数量的区块,前台按预设顺序输出。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。