How to install and configure widgets for the Dashboard tool for Sanity Studio

Installing widgets

You install Dashboard widgets the same way you'd install any studio plugin, or indeed any other package, using your preferred package manager.

You can find some popular widgets at the Sanity Exchange.

Browse widgets →

For example, if you want to install the cats example widget mentioned below, proceed as follows:

1. Install the widget in the root folder of your project.

2. Update your sanity.config.js file to include the widget in your plugins array.

3. You've now got a cat in your Studio!

Changing layout

A widget’s size can be defined by adding a layout key to the widget entry:

The accepted values for width and height are:

• auto
• small
• medium
• large
• full

Configuring widget options

Some widgets allow options to change aspects of their behavior. The configuration options should be part of the widget’s documentation found in its README.md. If you install the document-list widget (install sanity-plugin-dashboard-widget-document-list with npm or yarn as shown above), it can be configured with:

Thus, if you want your dashboard to display both newest documents across all document types and another widget showing the last edited books, your dashboard config would look like this: