Shopify Introduces Streamlined Metaobject API with Values Property

What Changed

Shopify has released an updated Metaobject API that introduces a new values property for simplified data handling. The property allows developers to fetch all fields of a metaobject in a single API call, with the response returning as a JSON-compatible object that requires no additional deserialization.

The values property works bidirectionally. When creating or updating metaobjects, developers can now provide a JSON-style object that matches the metaobject’s field keys. The API handles serialization automatically, eliminating the need for manual data transformation in application code. Optional fields are supported within this structure.

Impact for Shopify App Developers

This update reduces the code complexity required for metaobject operations. Previously, developers needed to implement custom deserialization logic to work with metaobject field data. The new approach removes this requirement, allowing direct use of returned data structures.

Apps that perform frequent metaobject read or write operations will see simplified codebases. The change is particularly relevant for apps managing custom data structures through Shopify’s metaobject system, such as product specifications, custom content types, or extended merchant data.

Implementation Considerations

Developers can adopt the values property alongside existing metaobject API methods. The update maintains backward compatibility with current implementations, allowing gradual migration to the new approach.

Apps currently handling metaobject serialization and deserialization manually can refactor to use the values property, reducing maintenance overhead and potential serialization errors. The JSON-compatible format aligns with standard data handling patterns in most programming languages.

Read the full announcement →