# Import Shopify Metafields Into Sanity

**Version:** v2026-07-28

**Published:** July 28, 2026

Sanity Connect can now bring your Shopify metafields across to Sanity. Product and collection metafields arrive on the synced documents as a `store.metafields` array, so custom data you already keep in Shopify — care instructions, specifications, size charts, or an external ID for updating Shopify resources — is queryable in GROQ alongside the rest of the product.

Each entry is keyed by `namespace.key` and carries the namespace, key, Shopify type, and value.

Values are deserialized, so structured types come through as real arrays, objects, and numbers instead of JSON-encoded strings:

**example.json**

```json
{
  "store": {
    "metafields": [
      {
        "_key": "custom.care_instructions",
        "namespace": "custom",
        "key": "care_instructions",
        "type": "multi_line_text_field",
        "value": "Hand wash only"
      },
      {
        "_key": "specs.dimensions",
        "namespace": "specs",
        "key": "dimensions",
        "type": "dimension",
        "value": {"value": 24.5, "unit": "CENTIMETERS"}
      }
    ]
  }
}
```

You choose what comes across in the Metafields tab, at the namespace level. Selecting a namespace imports every metafield in it; clearing your selection turns import off. Changes apply to each document as it next syncs — run a Resync to apply them everywhere at once, whether you are adding metafields or removing them.

The same tab also configures syncing Sanity content out to Shopify as metafields — the two directions are set up independently.

Imported metafields are owned by Shopify and read-only in Sanity. Each sync overwrites them, and your Sanity-authored fields stay separate and untouched.

**Variant metafields and metaobjects are not included in the import yet.**