Free Shopify Metafield Value Validator

Shopify metafields reject values that do not exactly match their type, and the Admin API error messages are not always clear. This free validator checks a value against the metafield type you pick — single-line text, integer, decimal, boolean, JSON, date, date-time, URL, color, rating, dimension, weight, volume, and list types — and tells you what is wrong and what the correct shape looks like. It runs entirely in your browser. It is built by the maker of the MetaGrid Shopify app and the BulkFix bulk metafield editor extension.

How to use metafield validator

1. Choose the metafield type from the dropdown (it matches Shopify's type identifiers).
2. Paste or type the value you intend to save.
3. The tool validates instantly and shows a pass/fail message.
4. For structured types (JSON, rating, dimension, list…) it also shows a normalized, pretty-printed version you can copy.
5. Fix the value until it passes, then use it in the Admin, the API, MetaGrid, or BulkFix.

Common uses

• Formatting a dimension metafield as {"value":12.5,"unit":"cm"} correctly
• Building a rating metafield object with value, scale_min, and scale_max
• Checking that a list.single_line_text_field value is a valid JSON array
• Validating a JSON metafield before a bulk import with MetaGrid or a CSV
• Confirming a date metafield is in YYYY-MM-DD format

Frequently asked questions

What format does a Shopify JSON metafield need?

It must be strictly valid JSON — double-quoted keys and strings, no trailing commas, no comments. This tool parses it with the browser's JSON engine and shows the error if it fails.

How do I format a dimension, weight, or volume metafield?

These are JSON objects with a numeric value and a string unit, for example {"value":10.5,"unit":"kg"} for weight. The valid units are the ones Shopify lists for each measurement type.

What does a rating metafield value look like?

A JSON object: {"value":"4.5","scale_min":"0","scale_max":"5"}. The value must fall within scale_min and scale_max.

Is this an official Shopify tool?

No. It is an independent free utility by Faraz Hussain, who also builds the MetaGrid app and the BulkFix extension for editing Shopify metafields in bulk.

Does it connect to my store?

No. It does no network requests and has no access to your Shopify store. It only checks the text you paste against the type rules.

This free tool is one of several browser-based AI utilities by Faraz Hussain, a Shopify developer and web engineer. See all free AI tools, what he's shipped, or the services.

Other free tools: JSON formatter · image compressor · Shopify metafield validator · UTM link builder · image to Base64 · slug generator · word counter