---
title: JSON metafield values limited to 128KB - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/posts/reduced-metafield-value-sizes'
  md: 'https://shopify.dev/changelog/posts/reduced-metafield-value-sizes.md'
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Admin REST API
      handle: admin-rest
    - displayName: Customer Account API
      handle: customer-account-graphql
    - displayName: Storefront API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: true
  createdAt: '2026-02-18T11:54:51-05:00'
  postedAt: '2026-02-19T12:00:00-05:00'
  updatedAt: '2026-02-26T13:53:41-05:00'
  effectiveAt: '2026-02-19T12:00:00-05:00'
---

February 19, 2026

# JSON metafield values limited to 128KB

DateFebruary 19, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

Flags[Breaking API Change](https://shopify.dev/changelog?filter=breaking-api-change)[Action required](https://shopify.dev/changelog?action_required=true)

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)[Admin REST API](https://shopify.dev/changelog?api_type=admin-rest)[Customer Account API](https://shopify.dev/changelog?api_type=customer-account-graphql)[Storefront API](https://shopify.dev/changelog?api_type=storefront-graphql)

When using API version 2026-04 or later, JSON type metafield writes will be limited to 128KB. Limits for all other metafield types remain unchanged ([current limits](https://shopify.dev/docs/apps/build/metafields/metafield-limits)). **All apps that use JSON fields (prior to April 1st, 2026), will be grandfathered at the current 2MB limit.** Large metafield values continue to be readable by all API versions, including future versions.

Large JSON metafield negatively impact storefront performance—particularly when multiple large values are loaded together, which can result in tens of megabytes of data being fetched for a single page. Our goal is to accommodate all current use cases while preventing performance issues stemming from extremely large values.

If you are a new app and believe you have a use case that requires >128KB JSON fields, please fill out this [form](https://docs.google.com/forms/d/e/1FAIpQLSdMEzS4NoKB3BfL3gjQMRhPT3ZNtZipzuBxVWy8SqJCYYBkMw/viewform?usp=publish-editor) to request access. Additional limits will be granted on a case by case basis.

**Note**: Initially, this change limited metafields to 16KB. After feedback from our developer community, we've revised those limits to accommodate more use cases and updated this post.