Content Releases Configuration
Configure Content Releases in Sanity Studio
Content Releases allow teams to organize and schedule updates across multiple documents. Teams can plan, preview, and validate significant changes in advance, ensuring seamless and conflict-free content deployment.
This document explores configuring Content Releases in Sanity Studio. For details on using Releases, or interacting with the API, follow these links:
Paid feature
Releases is available for all projects on the Growth plan and up. Release limits are set at the organization level.
Content Releases is enabled by default for studios running version 3.75.0 or later. You should update any official plugins and dependencies, such as AI assist, Vision, and any presentation-related plugins to ensure compatibility.
If you'd like to disable content releases for your studio, you can do so in the configuration file.
// sanity.config.ts / sanity.config.js
export default defineConfig({
// ...
releases: {
enabled: false
}
})
- Dataset imports don't work with datasets that contain versions. If you rely on regular imports, disable content releases until this is resolved or modify your export workflows to exclude version documents. We hope to have this resolved in the near future.
- When you schedule a release, we perform checks in the background to ensure reference integrity between documents. These checks do not take into account cross-dataset references.
- The JS client does not include methods for managing releases, but you can still send actions and queries to modify releases manually. See the Content Releases API documentation for details on using the API.
- API changes supporting Content Releases introduced changes to perspectives. See the changelog for details on breaking changes.
Content Release previews in Presentation work with front ends that use Loaders. This includes @sanity/core-loader
, @sanity/react-loader
, @sanity/svelte-loader
, and packages that rely on them such as next-sanity
(with a loader or defineLive
) and @nuxtjs/sanity
.
Configure your clients to use the 2025-02-19
version of the API to enable previewing.
For applications configured with official loaders and the presentation tool, presentation will preview Content Releases as expected. We're working to provide guidance for custom implementations in the future, however the preferred path is Presentation tool and Loaders.
Follow our guides for Visual Editing to configure presentation in your application.
Official plugins have been updated to support Releases. We recommend updating to the latest versions of any official plugins to ensure full compatibility.