Shopify Online Store 2.0

改 section 没反应?enabled_on 配置排查

商家侧感受#

在主题编辑器想把某 section 加到首页,列表里根本看不到;或加到商品页后提示不支持。开发者坚称“我写了 section”,但 enabled_on(或主题使用的模板限制)把可用模板收得太窄。

技术背景#

Online Store 2.0 section 可在 schema 用 enabled_on / disabled_on 限制模板类型与分组。例如仅 "templates": ["product"] 时,首页 index 不会出现该 section。写错模板名(products 复数、或自定义后缀没按规则写)等于锁死。商家在“自定义”里找区块找不到,常被误判为应用未安装。权威说明见 section schema。

处理#

  1. 打开 sections/你的区块.liquid 底部 {% schema %},定位 enabled_on / disabled_on。
  2. 对照需要出现的模板:index、product、collection、page 等,按官方枚举书写。
  3. 若只想限制“不能用于结账相关”,用 disabled_on 黑名单往往比白名单更不易误伤。
  4. 改完后重新加载主题编辑器(硬刷新),再在目标模板点“添加分区”。
  5. 预设 presets 名称只影响“添加”列表的显示名,不替代 enabled_on。
  6. 给商家的说明里写清:该分区仅适用于哪些模板,避免反复工单。

验收#

目标模板的添加列表能看到该 section;不应出现的模板仍没有入口;schema JSON 可解析。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。