Shopify UI extension metafields accept owner_type
Introduced 2026-10-08 · score 0.96
HOW TO USE IT
When configuring metafields for a checkout or customer account UI extension, add `owner_type` to each declaration to identify the resource that owns it. On API version 2026-10 it is optional; Shopify's docs list `PRODUCTVARIANT` and `CUSTOMER` as supported values.
[[extensions.metafields]]
namespace = "$app"
key = "energy-rating"
owner_type = "PRODUCTVARIANT"
[[extensions.metafields]]
namespace = "custom"
key = "age-verification-required"
owner_type = "CUSTOMER"WHY THIS HELPS
Configure metafield declarations for a checkout or customer account UI extension with an owner type.
REQUIREMENTS AND LIMITATIONS
- Version: 4.9.0
- extensions.metafields.namespace (required): Metafield namespace.
- extensions.metafields.key (required): Metafield key.
- extensions.metafields.owner_type: Resource type that owns the metafield. Supported values include `PRODUCTVARIANT` and `CUSTOMER`.
- Prerequisite: `owner_type` is accepted from API version `2026-10`; it is optional in that version.
- The change applies to checkout and customer account UI extensions.
- `owner_type` is optional.
FIRST-PARTY EVIDENCE
- https://github.com/Shopify/cli/releases/tag/4.9.0
- https://github.com/Shopify/cli/pull/8534
- https://shopify.dev/docs/apps/build/checkout/metafields
Check the installed version and the source before using it. Entry JSON