从 API 版本 2026-10 开始，Checkout 和 Customer Account UI 扩展可以在 shopify.extension.toml 中为每个 metafield 声明指定一个 owner_type。从 API 版本 2027-01 开始，owner_type 是每个 metafield 声明所必需的，缺少该声明的部署将被阻止。
变更内容
[[extensions.metafields]] 和 [[extensions.targeting.metafields]] 中的 metafield 声明接受一个新的 owner_type 属性。owner_type 命名拥有该 metafield 的资源，例如 PRODUCT 或 CUSTOMER。
Shopify 使用 owner_type 仅获取您的扩展所需资源类型的 metafield，从而提高扩展性能。在 API 版本 2027-01 及更高版本中，每个 metafield 声明都必须包含 owner_type。
受影响对象
在 shopify.extension.toml 中声明 metafield 并使用 API 版本 2027-01 或更高版本的 Checkout 和 Customer Account UI 扩展会受到影响。
未在 shopify.extension.toml 中声明 metafield 的扩展不受影响。
操作步骤
在 API 版本 2027-01 或更高版本中，如果任何 metafield 声明缺少 owner_type，部署将被阻止。请在升级前向每个 metafield 声明添加 owner_type。您现在可以在 2026-10 上添加它。
迁移步骤：
- 打开扩展的 shopify.extension.toml 文件，并为每个 metafield 声明添加适当的 owner_type 值。
- 如果您的扩展需要从多个资源类型获取相同的 namespace 和 key，请为每个 owner_type 创建单独的声明。
- 重新部署扩展，并确认部署完成且未出现与 metafield 声明相关的验证错误。
相关文档
- 为 Checkout UI 扩展配置 metafields
- 为 Customer Account UI 扩展配置 metafields