How AI is powering better personalization in e-commerce [with Vercel]. Sign up now →

Set initialValue for block field without manual key assignment

5 repliesLast updated: Nov 29, 2025

Hello đź‘‹I'm trying to pre-fill or set the
initialValue
of a field of type
block
. I get the following warning on the Studio side. Clicking "Set a new random_key.." seems to work but is there a way of this being automatically set without needing to click it?
        defineField({
          title: "Description",
          name: "description",
          type: "array",
          of: [{ type: "block" }],
          initialValue: [
            {
              _type: "block",
              children: [
                {
                  _type: "span",
                  marks: [],
                  text: "Hello there\n\nThis is a new line!",
                },
              ],
              markDefs: [],
              style: "normal",
            },
          ],
        }),
AI Update

Yes, you're encountering the _key warning because block content in Sanity requires unique _key properties for each object in the array structure, including both the block itself and its children.

The solution is to explicitly add _key values using a UUID generator. Here's the working approach:

import {v4 as uuidv4} from 'uuid'

defineField({
  title: "Description",
  name: "description",
  type: "array",
  of: [{ type: "block" }],
  initialValue: [
    {
      _key: uuidv4(),
      _type: "block",
      children: [
        {
          _key: uuidv4(),
          _type: "span",
          marks: [],
          text: "Hello there\n\nThis is a new line!",
        },
      ],
      markDefs: [],
      style: "normal",
    },
  ],
})

Important notes:

There is an autoGenerateArrayKeys: true option in the Sanity client config, but this only applies when writing documents via the client API, not for schema-level initialValue definitions. As confirmed in the Sanity community discussion, it's not possible to use this approach with initialValue.

The manual UUID approach is the recommended solution and will eliminate the warning while ensuring your initial block content is properly structured.

Show original thread
5 replies

Was this answer helpful?

Sanity – Build the way you think, not the way your CMS thinks

Sanity is the developer-first content operating system that gives you complete control. Schema-as-code, GROQ queries, and real-time APIs mean no more workarounds or waiting for deployments. Free to start, scale as you grow.

Related contributions