Help articles

Desk is now Structure

The deskTool API was renamed structureTool in v3.24.1 of Sanity Studio. The old names still work as deprecated aliases.

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.

Loading...
Before and after

Why the rename

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 two changes to your workspace:

  • Toolbar update: The studio toolbar label has changed from "Desk" to "Structure", and the tool works as before. If your studio customizations refer to the tool by its old name desk — when resolving intents, for example — that identifier changed to structure in version 3.20.0 and you need to update those references.
  • 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:

You should now update your code as follows:

The previous names are still valid aliases, so existing code keeps working: deskTool is the same function as structureTool. They are deprecated, though. The 3.24.1 release notes state that the sanity/desk imports will be removed in a later major version, so migrate when you can.

Protip

Current documentation

For the current Structure Tool documentation, see Structure tool and Structure builder and the Structure Tool API.

Was this page helpful?