Metafield Size Limit
This guide explains the metafield size limit error and how to resolve it by splitting a large price list into smaller ones.
The error
Section titled “The error”When saving or syncing a price list, you may see an error saying the pricing data is too large to fit in the shop metafield and the list needs to be split into smaller lists.
Why it happens
Section titled “Why it happens”Qivra B2B Wholesale compiles every price list’s rules into a single shop metafield that the storefront and checkout read. Shopify caps the size of a metafield. A price list with a very large number of per-variant overrides or price-break tiers can exceed that cap, so the sync fails.
How to fix it
Section titled “How to fix it”Split the offending price list into several smaller price lists. Common strategies:
1. Split by collection or product tag
Section titled “1. Split by collection or product tag”Instead of one list covering many collections, create one list per collection (or per product tag). Each list then contains fewer variants.
2. Split per-variant overrides
Section titled “2. Split per-variant overrides”If the list has thousands of per-variant overrides, distribute them across multiple Specific variants lists, each covering a subset of variants.
3. Move large price-break tables to their own list
Section titled “3. Move large price-break tables to their own list”If a list has many tiers across many products, separate the high-volume tiered products into their own list.
After splitting
Section titled “After splitting”- Set the same Customer selection, Market selection, and (if needed) Priority on each split list so the behavior matches.
- Activate each list and confirm the Metafield sync reaches Up to date.
- Verify prices on the storefront.
Check sync health
Section titled “Check sync health”After any change, monitor the Metafield sync status panel. If a list still fails, split further or contact support with the failed-variant samples from the Advanced panel.
Related docs
Section titled “Related docs”- Product selection & per-variant overrides
- Metafield sync status
- Create your first price list
- Manage price lists