Shopify Metaobject values updates differ from patches that preserve omitted fields
Convenient serialization through values comes with clearing semantics. Record the intent to retain fields as a separate contract.
Untouched on a screen does not mean retained
Fields omitted from values are cleared rather than preserved by a patch. A call intended to make a partial edit must first select the appropriate update semantics. An operator may believe only a description changed while a request generator omits the other fields and removes existing information. The useful acceptance basis is which values were meant to survive, not merely the field count. [1, 2, 3]
Simplified serialization, different mutation behavior
Shopify's 2026-06-11 announcement introduces values in the 2026-07 Metaobject API for reading and writing JSON-compatible objects. The API handles serialization, but defined fields omitted from values are cleared. Existing field and fields remain available for additional type details or patch-style mutations that leave unspecified fields unchanged. [1]
Make retention intent part of the handoff
The content-operations owner should distinguish changed fields from fields to retain. For a partial change, verify whether patch behavior is selected, then compare retained fields before and after. Record intentional deletion of an optional field as an approved exclusion from retention checks. A post-change value alone cannot reveal whether its absence was deliberate, so preserve the original as well. [1, 3]
A fixture intended to edit only another field
Define an illustrative edit that retains the display color blue while changing another field. The expected retained value is blue. A post-edit blue preserves that intent. A cleared result calls for investigation of replacement semantics used for a partial edit. Here cleared is readable test notation for absence, not an actual API string. Filling a default color without checking the original can create a second unintended change. [1, 3]
Truthound exposes the gap between intent and outcome
ColumnPairValidator in Truthound Core 3.3.2 can compare a prepared pre-change reference with the post-change value. It skips null pairs, so retain deletion state as explicit presence information and combine the comparison with required-value and state checks. The product does not mutate metaobjects or restore deleted values. Consider patch behavior for partial edits, or include retained fields when using values. If complete replacement and deletion were intended, do not impose before/after equality. [1, 2, 3]
Application conditions
In 2026-07 or later, distinguish values mutation semantics from field and fields. Preserve the source pre-change value for each field to retain, excluding intentional deletions through separate approval.
Alternatives
For a partial edit, use patch behavior through field and fields. If using values, include all fields intended to survive.
Limitations
Truthound does not modify metaobjects or recover deleted values. Omission itself is not a product defect; the check concerns a conflict between mutation semantics and user intent.
Evidence
- Event checked
- Subject checked
- Modified
