The Gap Between "Stable" and "Documented"

If you build on the Shopify Admin API, you know the drill: you pin your app to a specific API version, you test against the latest stable release, and you ship. Simple. But recently, a pattern has emerged that breaks that assumption.

A developer on the Shopify Community forums pointed out a discrepancy regarding the owner_type field for metafield declarations in Checkout and Customer Account UI extensions. The documentation states this field becomes required in API version 2027-01 . However, the change was introduced in 2026-10 , which reached stable status on October 1st. Yet, the changelog entry describing this breaking change was published on October 8th.

To a senior developer, this looks like a documentation lag. To an app developer relying on webhooks or scheduled jobs, it’s a potential production incident waiting to happen. Is Shopify still iterating on "stable" releases after they are marked stable?…