Sanity Studio v4 is live! Learn more about the Node.js 20+ requirement, and upgrade today.

Sanity logo

Documentation

    • Overview
    • Platform introduction
    • Next.js quickstart
    • Nuxt.js quickstart
    • Astro quickstart
    • React Router quickstart
    • Content Lake
    • Compute and AI
    • APIs and SDKs
    • Dashboard
    • Studio
    • Canvas
    • Media Library
    • App SDK
    • HTTP API
    • CLI
    • Libraries
    • Specifications
    • Changelog
    • User guides
    • Developer guides
    • Courses and certifications
    • Join the community
    • Templates
Studio
Overview

  • Setup and development

    Installation
    Project Structure
    Development
    Hosting and deployment
    Embedding Sanity Studio
    Upgrading Sanity Studio
    Environment Variables
    Using TypeScript in Sanity Studio
    Auto-updating Sanity Studio

  • Configuration

    Introduction
    Workspaces
    Schema and forms
    Conditional fields
    Field Groups
    List Previews
    Connected Content
    Validation
    Initial Value Templates
    Cross Dataset References
    Sort Orders
    Visual editing and preview

  • Block Content (Portable Text)

    Introduction
    Configure the Portable Text Editor
    Customize the Portable Text Editor
    Create a Portable Text behavior plugin
    Add Portable Text Editor plugins to Studio
    Common patterns

  • Studio customization

    Introduction
    Custom authentication
    Custom asset sources
    Diff components
    Form Components
    How form paths work
    Icons
    Favicons
    Localizing Sanity Studio
    New Document Options
    Studio Components
    Studio search configuration
    Focus and UI state in custom inputs
    Real-time safe patches for input components
    Sanity UI
    Studio Tools
    Create a custom Studio tool
    Tools cheat sheet
    Theming

  • Workflows

    The Dashboard tool for Sanity Studio
    Add widgets to dashboard
    Document actions
    Custom document badges
    Localization
    Content Releases Configuration
    Enable and configure Comments
    Configuring Tasks
    Scheduled publishing

  • Structure builder

    Structure tool
    Introduction to Structure Builder
    Set up Structure Builder to override the default list view
    Create a link to a single edit page in your main document type list
    Manually group items in a pane
    Dynamically group list items with a GROQ filter
    Create custom document views with Structure Builder
    Cheat sheet
    Reference

  • Plugins

    Installing and configuring plugins
    Developing plugins
    Publishing plugins
    Internationalizing plugins
    Reference

  • AI Assist

    Installation
    Translation
    Custom field actions

  • User guide

    Comments
    Task
    Copy and paste fields
    Content Releases
    Compare document versions

  • Studio schema reference

    Studio schema configuration
    Array
    Block
    Boolean
    Cross Dataset Reference
    Date
    Datetime
    Document
    File
    Geopoint
    Global Document Reference
    Image
    Number
    Object
    Reference
    Slug
    Span
    String
    Text
    URL

  • Studio reference

    Asset Source
    Configuration
    Document
    Document Badges
    Document Actions
    Form
    Form Components
    Hooks
    Structure tool
    Studio Components Reference
    Tools
    Initial Value Templates
    Studio API reference

StudioLast updated July 7, 2025

Cross Dataset References

  • Article
  • Changelog

Cross-dataset references now respect query perspective

v2025-06-19

Requests containing cross-dataset references (CDR) now respect the perspective of the query.

For example, if a document is requested with the 'drafts' perspective, its cross-dataset references will be resolved as if they were queried with the `drafts` perspective as well.

Previously, queries containing CDRs would always return the published version of the CDR documents, regardless of the originating query's perspective.

Breaking changes

To continue using the previous behavior, use an API version prior to 2025-06-19. Updating to 2025-06-19 or later will cause requests containing CDRs to use the query's perspective.

On this page

  • The anatomy of a cross-dataset reference
  • Exploring the crossDatasetReference schema
  • The Cross-Dataset Reference field in your studio.
  • Editor support for cross-dataset references
  • Querying cross-dataset references
  • In conclusion
Sanity logosanity.ioAll Systems Operational© Sanity 2025
Change Site Theme