Metafield limits
This document outlines the various limits for metafields and their definitions per shop, including apps.
Anchor to Metafield definition limitsMetafield definition limits
Standard metafield definitions don't count towards limits unless specified.
Standard metafield definitions don't count towards limits unless specified.
Anchor to App definitionsApp definitions
Each app installed on a shop can create up to 256 metafield definitions per resource type.
Anchor to Merchant definitionsMerchant definitions
Merchants can create up to 256 metafield definitions per resource type.
Anchor to Other limitsOther limits
| Limit type | Limit |
|---|---|
| Pinned definitions limit per resource type | 20 |
Anchor to Metafield type size limitsMetafield type size limits
Apps using JSON fields before April 1, 2026 will be grandfathered at the current 2MB limit. New apps requiring >128KB JSON fields may request an exception via this form.
Apps using JSON fields before April 1, 2026 will be grandfathered at the current 2MB limit. New apps requiring >128KB JSON fields may request an exception via this form.
| Type | Size limit |
|---|---|
boolean | 65KB |
color | 65KB |
date | 65KB |
date_time | 65KB |
dimension | 65KB |
id | 2KB |
json | 128KB |
link | 65KB |
money | 65KB |
multi_line_text_field | 65KB |
number_decimal | 65KB |
number_integer | 65KB |
rating | 65KB |
rich_text_field | 65KB |
single_line_text_field | 65KB |
url | 2KB |
volume | 65KB |
weight | 65KB |
Single line text metafield predefined choices are limited to 128 values.
Single line text metafield predefined choices are limited to 128 values.
Anchor to Lists type limitsLists type limits
All list types (collection, customer, date and time, decimal, dimension, file, integer, JSON, link, mixed reference, money, multi line text, page, product, product taxonomy, rating, single line text, URL, variant, volume, and weight) have a maximum of 128 items. The only exception is metaobject references, which support up to 256 items.
- Each item in the list has the same size limits as its corresponding single value type. For example, each text field in a
list.single_line_text_fieldcan store up to 65 KB. - You can use the
list.minandlist.maxvalidations through the GraphQL Admin API to set custom minimum and maximum limits for the number of items in a list, as long as they don't exceed the maximum size limits.
- Each item in the list has the same size limits as its corresponding single value type. For example, each text field in a
list.single_line_text_fieldcan store up to 65 KB. - You can use the
list.minandlist.maxvalidations through the GraphQL Admin API to set custom minimum and maximum limits for the number of items in a list, as long as they don't exceed the maximum size limits.
Anchor to Metafield definition capability limitsMetafield definition capability limits
| Limit type | Limit |
|---|---|
| Used to power smart collections | 128 |
| Use as admin filter on Products, Companies, Company Locations, or Metaobjects | 128 |
| Use as admin filter on Orders | 5 |
Metafield definition capabilities extend metafield functionality. Learn more about metafield capabilities.
Metafield definition capabilities extend metafield functionality. Learn more about metafield capabilities.