---
title: Metafield limits
description: Limits on metafields available per merchant store.
source_url:
  html: 'https://shopify.dev/docs/apps/build/custom-data/metafields/metafield-limits'
  md: >-
    https://shopify.dev/docs/apps/build/custom-data/metafields/metafield-limits.md
---

# Metafield limits

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

### Metafield definition limits

Note

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

#### App definitions

Each app installed on a shop can create up to 128 metafield definitions per resource type.

#### Merchant definitions

Merchants can create up to 256 metafield definitions per resource type.

#### Other limits

| Limit type | Limit |
| - | - |
| Pinned definitions limit per resource type | 20 |

### Metafield 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.

### Lists 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 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.

### Metafield 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 capabilities](https://shopify.dev/docs/apps/build/custom-data/metafields/use-metafield-capabilities).

***