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.
Most metafield types have a 64KB (65,536 bytes) size limit, with the following exceptions:
| Type | Size limit |
|---|---|
id | 2KB |
json | 128KB |
url | 2KB |
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 have a maximum of 128 items except 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 64KB (65,536 bytes). - 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 64KB (65,536 bytes). - 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 | 50 |
| 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.