Metafield limits

This document outlines the various limits for metafields and their definitions per shop, including apps.

Anchor to Metafield definition limitsMetafield definition limits

Note

Standard metafield definitions don't count towards limits unless specified.

Limit Type	Limit
Definitions per resource type	250
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

Note

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.

Note

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_field can store up to 65k characters).
You can use the list.min and list.max validations through the Shopify 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 items shown above.

Anchor to Metafield definition capability limitsMetafield definition capability limits

Limit Type	Limit
Used to power smart collections	128
Use as admin filter	128

Note

Metafield definition capabilities extend metafield functionality. Learn more about metafield capabiltiies.

Was this page helpful?