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

Most metafield types have a 64KB (65,536 bytes) size limit, with the following exceptions:

| Type | Size limit |
| - | - |
| `id` | 2KB |
| `json` | 128KB |
| `url` | 2KB |

**Note:**

Single line text metafield predefined choices are limited to 128 values.

### Lists type limits

All [list types](https://shopify.dev/docs/apps/build/metafields/list-of-data-types#list-types) have a maximum of 128 items except 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 64KB (65,536 bytes).
* 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 | 50 |
| 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).

***