A
argbe.tech - news
1min read

Shopify metafields now cap writes at 16KB — how to migrate large payloads safely

Shopify set a 16KB limit for metafield write values in Admin GraphQL API version 2026-04. Apps that write larger values need to split data across metafields or move it to metaobjects or the Files API.

In Shopify Admin GraphQL API version 2026-04, metafield write values are limited to 16KB, affecting any app that writes values over that size.

  • The 16KB cap applies when writing metafields on API version 2026-04 or later; apps on version 2026-01 or earlier aren’t subject to this write limit.
  • Oversized metafield values remain readable across Shopify API versions (including future versions), even if they can’t be written back as-is.
  • Shopify said extremely large values can hurt storefront performance, and this limit is intended to prevent those performance issues.
  • Migration options Shopify recommended include metaobject references for larger structured data, list support for multiple values, or splitting data across multiple metafields with logical grouping.
  • For large content blobs, Shopify recommended storing the content via the Files API instead of a metafield value.