Metaobjects import improvements and Matrixify compatibility

Enhanced metaobject imports with better field processing, improved error handling, and Matrixify-compatible grouping behavior.

MetaobjectsImportsMatrixify

Changelog

July 30, 2025


We’ve improved metaobject imports with better field processing, enhanced error handling, and full Matrixify compatibility for grouping behavior.


πŸš€ What’s New

  • Matrixify-compatible grouping – when no ID or Handle columns are present, all rows will be grouped for the same metaobject, matching Matrixify behavior exactly.

πŸ”§ Improvements

  • Enhanced field processing – metaobject fields now use the same robust reference resolution logic as metafields, ensuring consistent handling of file references, product references, and other reference types.
  • Real-time API queries – removed caching in favor of direct API queries for each metaobject lookup, ensuring you always get the most current data from Shopify.
  • Better error messages – added specific error codes MOBJ004 and MOBJ005 for missing definition types and definition not found scenarios.

πŸ› Fixes

  • Fixed error code typo – corrected MBOJ002 to MOBJ002 for consistency with other metaobject error codes.

πŸ“‹ Technical Details

These improvements ensure that:

  • File references like "image.jpg" are properly resolved to Shopify file GIDs
  • List references are correctly formatted as JSON arrays
  • Reference metafields work consistently between regular metafields and metaobject fields
  • Error messages provide clear guidance on how to resolve import issues