---
title: Metafield limits
description: Limits on metafields available per merchant store.
source_url:
  html: 'https://shopify.dev/docs/apps/build/metafields/metafield-limits'
  md: 'https://shopify.dev/docs/apps/build/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 256 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 size limits

**Info:**

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](https://docs.google.com/forms/d/e/1FAIpQLSdMEzS4NoKB3BfL3gjQMRhPT3ZNtZipzuBxVWy8SqJCYYBkMw/viewform).

| 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 |

**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 size limits as its corresponding single value type. For example, each text field in a `list.single_line_text_field` can store up to 65 KB.
* 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 size limits.

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

**Note:**

Metafield definition capabilities extend metafield functionality. Learn more about [metafield capabilities](https://shopify.dev/docs/apps/build/metafields/use-metafield-capabilities).

***