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

Configuring Tasks

Learn how to enable, configure, and use the Tasks feature in Sanity Studio for effective team collaboration on content creation.

The Tasks feature for Sanity Studio enables your content creation team to collaborate more effectively right where the work is done. The feature is enabled by default for any eligible project, but can be disabled with a single line of configuration, should you wish to do so.

Paid feature

This article discusses a feature that is available for projects on the Growth plan and up. Visit our pricing page to learn about Sanity’s different plan offerings.

Enable and configure tasks in your studio

Tasks are enabled by default for all eligible projects. If you’d rather opt out for now, you can do so by adding the following property to your main studio configuration:

// ./sanity.config.ts|js

export default defineConfig({
  // ... rest of config
	tasks: { enabled: false },
})

Where are tasks stored?

To keep everything neat and tidy, tasks are stored parallel to your content in a complimentary dataset, along with other workflow and collaboration data, such as Comments.

These datasets:

  • Do not count toward the data limit of your current plan.
  • Do not incur any extra costs for your project.
  • Are listed in the project management pages under Datasets, along with all existing datasets for a project.
  • Include a distinctive suffix in the dataset name. This is a best-effort attempt, and the result may vary, depending on the character length of the name of the related document dataset. Examples:
    • <related-document-dataset>-comments
    • <related-document-dataset>-cmts
    • <related-document-dataset>-cmt
    • <related-document-dataset>-c
  • Are searchable: you can query comment datasets with GROQ or GraphQL.

Permissions for tasks and comments

All roles need to have these permissions to be able to use comments and tasks fully:

Management permissions
"Project details" read => For feature flag
"Project members" read => @mention members
"Project datasets" read => View all comments with count

Content permissions
"All documents" read on main dataset(s) used in your Studio/workspaces

Was this article helpful?