Go Behind the Experience to see how Tecovas brings the West to life with Sanity 🤠 July 18th

Desk is now Structure

The version 3.20.0 update to Sanity Studio introduced a notable change: the tool previously known as "Desk" has been renamed to "Structure".

You may notice this renaming in the toolbar menu of your studio, as well as in the path segment of your studio URLs.

Before and after

Why the Change?

The "Desk" name suggested a singular, one-size-fits-all approach to content management. As Sanity Studio has grown, so have its capabilities. With features like Presentation broadening your content interaction options, Structure is a more appropriate and descriptive name that reflects its status as one of the many diverse ways you can shape and organize your content models.

For Studio Users

This update brings a minor yet significant change to your workspace:

  • Toolbar Update: The studio toolbar label has changed from "Desk" to "Structure". Rest assured, this change is purely cosmetic, with no impact on the functionality you're familiar with.
  • URL Path Update: The initial path segment of your studio URLs has changed from /desk to /structure. Existing bookmarks will automatically redirect, so there's no immediate need to update them.

For Studio Maintainers

As of version 3.24.1, the deskTool has been renamed structureTool and is found in sanity/structure. In other words, where you'd previously do this:

import {defineConfig} from 'sanity'
import {deskTool} from 'sanity/desk'
export default defineConfig({ // ...rest of config plugins: [
deskTool(),
] })

You should now update your code as follows:

import {defineConfig} from 'sanity'
import {structureTool} from 'sanity/structure'
export default defineConfig({ // ...rest of config plugins: [
structureTool(),
] })

No rush! Everything will still work as before since we are keeping the previous naming around as valid aliases, but going forth you should get used to the structureTool.

Protip

The Sanity Command Line Interface has a handy codemod to help you update your code with almost no effort! Run the following command in your studio root directory:


npx @sanity/cli codemod deskRename

Be sure to check in any local changes to version control before running the codemod in case it should fail!

Moving Forward

This renaming is a step towards a more adaptable and intuitive Sanity Studio. We appreciate your flexibility and dedication as we evolve the platform to better meet your needs.

The 'Desk' name suggested a singular, one-size-fits-all approach to content management. As Sanity Studio has grown, so have its capabilities. With features like 'Presentation' broadening your content interaction options, 'Structure' is a more appropriate and descriptive name that reflects its status as one of the many diverse ways you can shape and organize your content models.

import defineConfig from 'sanity'
import structureTool from 'sanity/structure'

export default defineConfig( 
  // ...rest of config
  plugins: 
    structureTool(),

 )

Protip

The Sanity Command Line Interface has a handy codemod to help you update your code with almost no effort! Run the following command in your studio root directory:

npx @sanity/cli codemod deskRename

Was this article helpful?