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.
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 character limitsMetafield type character limits
| Type | Character limit |
|---|---|
boolean | 65k |
color | 65k |
date | 65k |
date_time | 65k |
dimension | 65k |
id | 2,048 |
json | 2m |
link | 65k |
money | 65k |
multi_line_text_field | 65k |
number_decimal | 65k |
number_integer | 65k |
rating | 65k |
rich_text_field | 65k |
single_line_text_field | 65k |
url | 2,048 |
volume | 65k |
weight | 65k |
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 character limits as its corresponding single value type. For example, each text field in a
list.single_line_text_fieldcan store up to 65k characters. - 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 character limits.
Anchor to Metafield definition capability limitsMetafield definition capability limits
| Limit type | Limit |
|---|---|
| Used to power smart collections | 128 |
| Use as admin filter | 128 |
Metafield definition capabilities extend metafield functionality. Learn more about metafield capabilities.