商品标题翻译了但自定义字段还是英文怎么办

现象#

商品标题和描述在法语站已正常显示，商品页的「材质」自定义字段仍是英文原文，Translate & Adapt 里也搜不到这个字段。

原因#

• metafield 定义未标记为可翻译，翻译系统不会为它生成资源记录
• 数字、布尔、URL 等类型本身不可翻译，只有文本类字段能登记译文
• 字段没开放 storefront 读取权限，主题读到的始终是原始值
• 主题直接输出整个 JSON 值，没有按子字段逐项注册翻译

处理步骤#

1. 到 Settings > Custom data 打开该定义，确认类型为文本并勾选可翻译
2. 用 translationsRegister 以 metafield 的 GID 与 digest 注册法语译文
3. 检查定义的 storefront access 为 PUBLIC_READ，否则 Liquid 读不到
4. 前台改用 {{ product.metafields.custom.material.value }} 输出纯文本
5. 用 Storefront API 的 @inContext(language: FR) 查询同一字段交叉验证

验收标准#

切到 /fr 商品页该字段显示法语值；Admin API 查 translatableResource 能看到该 metafield 的 fr 记录。