👋 Next.js Conf 2024: Come build, party, run, and connect with us! See all events

Structure tool

Customize the document browsing and management experience in Sanity Studio with the Structure tool.

The Structure tool is included with Sanity Studio and allows you to customize the experience of creating, browsing, and managing documents.

Install

New projects come pre-configured with the Structure tool. For existing projects, or if it isn’t part of your Studio configuration, you can install it by updating your project’s configuration file.

// sanity.config.ts
import {defineConfig} from 'sanity'
import {structureTool} from 'sanity/structure'

export default defineConfig({
  // ...
  plugins: [structureTool()],
})

Is Structure a tool or a plugin?

Wondering why you’re adding a tool to the plugins array? Plugins are containers for shared tools, components, and other Studio configuration settings.

You can configure the Structure tool beyond the default settings by passing a configuration object to structureTool . The Structure tool API reference describes the list of available configuration options.

Customize

The Structure tool includes Structure Builder, an API that allows you to customize the way lists, documents, views, and menus are organized within Studio.

Start customizing your studio with the Introduction to Structure Builder series.

Additional resources

Was this article helpful?