owner_type を追加Checkout と Customer Account の UI 拡張で、shopify.extension.toml のメタフィールド宣言に「どのリソースのメタフィールドか」を書けるようになった。2026-10 では任意、2027-01 以降は必須。Shopify は必要なリソース分だけ取得するので拡張のパフォーマンスが上がる。
owner_type プロパティが追加され、「このメタフィールドの持ち主はどのリソースか」を宣言できるようになる。API バージョン 2027-01 からは必須。
メタフィールド宣言は namespace / key で指定。どのリソース種別のものかは宣言に含まれていなかった。
PRODUCT や CUSTOMER のように持ち主を宣言。Shopify は拡張が必要とするリソース種別のメタフィールドだけを取得する。
| 条件 | 影響 | 補足 |
|---|---|---|
| Checkout UI 拡張で、toml にメタフィールドを宣言し、API 2027-01 以降を使う | 影響あり | 全宣言に owner_type が必要 |
| Customer Account UI 拡張で、toml にメタフィールドを宣言し、API 2027-01 以降を使う | 影響あり | 全宣言に owner_type が必要 |
| 上記拡張で API 2026-10 を使う | 任意 | 指定可能。先行対応の推奨タイミング |
| toml にメタフィールドを宣言していない拡張 | 影響なし | 対応不要 |
[[extensions.metafields]]拡張全体レベルのメタフィールド宣言。owner_type プロパティを受け付ける。
[[extensions.targeting.metafields]]ターゲット単位のメタフィールド宣言。こちらも owner_type プロパティを受け付ける。
以下は記事の説明をもとにした記述イメージ。namespace / key の値は説明用。owner_type の取り得る値は記事中では PRODUCT・CUSTOMER が例として挙がっているのみで、全一覧は記載なし（関連ドキュメント参照）。
拡張の shopify.extension.toml を開き、各メタフィールド宣言に適切な owner_type を書き足す。
同じ namespace / key を複数のリソース種別から使う場合は、owner_type ごとに別の宣言を作る。
拡張を再デプロイし、メタフィールド宣言に関するバリデーションエラーが出ずに完了することを確認。
2027-01 以降、owner_type が 1 つでも欠けていればデプロイが通らない。CI/CD で拡張をデプロイしている場合はパイプラインが止まる前提で備える。
[[extensions.metafields]] と [[extensions.targeting.metafields]] の両方。ターゲット側の宣言の追加漏れに注意。
同じ namespace / key でも複数リソースから読むなら宣言を分ける。既存宣言が実際どのリソースのデータを読んでいるかの棚卸しが前提になる。
Shopify が必要なリソース種別のメタフィールドだけを取得するための情報。owner_type を正しく書くことが、そのまま拡張の取得量を絞ることにつながる。
記事で例示されている owner_type は PRODUCT と CUSTOMER のみ。指定可能な値の全一覧や、owner_type を間違えた場合に拡張側でどう値が返るかは記載なし。関連ドキュメント「Configure metafields for Checkout UI extensions」「Configure metafields for Customer Account UI extensions」で確認すること。
shopify.extension.toml からメタフィールド宣言を洗い出し、2026-10 のうちに owner_type を追加して再デプロイ。