Rule catalogue
Each rule is a Sanity document with typed conditions, the version where behavior changes, what happens now and after a bump, and a verbatim quote from the doc that proves it. The engine fires a rule only when every condition holds.
14 verified rules · loaded from the Sanity dataset · query it yourself ↗
apiVersion-dynamicapiVersion is computed datenew Date()) means your API version changes every day”apiVersion-missingcallSite in createClient,withConfigANDapiVersion is missingapiVersion, the JS client logs a deprecation warning and uses v1, the original API version.published, not raw).v1 of the API.”raw to published.”apiVersion-unresolved-envapiVersion is computed env,undefinedapiVersion: undefined, which throws instead of falling back.vXapiVersion-vXapiVersion = vXvX is the experimental version and can change at any time without notice.bump-hides-draftstoken is presentANDapiVersion < 2025-02-19ANDperspective is unsetANDquery matches /…/drafts. IDs and depend on the pre-2025-02-19 default perspective (raw), which returns draft documents to authenticated requests.published, which excludes drafts. The same queries will silently return no draft documents.raw to published.”raw to published.”drafts-leak-raw-defaultcallSite in createClient,withConfigANDtoken is presentANDapiVersion < 2025-02-19ANDperspective is unsetraw. Authenticated raw queries return draft documents (drafts.*) next to published ones, so unpublished edits can reach production.published. Bumping the version silently stops returning drafts, which fixes the leak but changes what any preview code built on it sees.raw to published.”raw perspective returns all drafts, versions, and published content side by side for authenticated requests.”raw to published.”previewDrafts was renamed to draftspreviewDrafts-deprecatedperspective = previewDraftspreviewDrafts still works and behaves like drafts.drafts on the latest APIs.drafts perspective used to be called previewDrafts. They both work, but if you're using the latest APIs, you should transition to drafts.”drafts perspective with the CDN not disableddrafts-requires-no-cdnperspective in drafts,previewDraftsANDuseCdn in true,unsetuseCdn is not false, the client bypasses the CDN anyway and logs a warning on every request.useCdn is not set to false.”listen() without includeAllVersionslisten-include-all-versionscallSite = listenANDlistenOption is absent includeAllVersionsincludeAllVersions, so it won’t get change events for Content Release version documents.client.listen, you'll need to forward includeAllVersions=true in order to listen for version and draft document changes.”includeAllVersions parameter. Set it to true and use an authenticated request to include all versions.”projection-empty-stringquery matches /…/ANDapiVersion < 2025-02-19"" incorrectly spreads its object into the parent, and your query depends on that."" key, so the response shape changes.raw resultsraw-bump-adds-versionsperspective = rawANDapiVersion < 2025-02-19raw returns published and drafts.* documents only. versions.* documents are not returned.raw also returns versions.* documents, so result sets can grow and include unreleased content.versions. prefixed documents in addition to drafts. and published documents.”versions.** documents are not returned in API versions prior to 2025-02-19. You must opt-in to this version to query versions-prefixed documents.”raw also returns Content Release versionsraw-now-includes-versionsperspective = rawANDapiVersion ≥ 2025-02-19raw returns versions.* documents (Content Release versions) in addition to drafts.* and published documents. Code that only expects two kinds of IDs may show duplicates.versions. prefixed documents in addition to drafts. and published documents.”versions-invisible-pre-2025query matches /…/ANDapiVersion < 2025-02-19versions.** documents.versions.** documents are not returned in API versions prior to 2025-02-19. You must opt-in to this version to query versions-prefixed documents.”useClient-releasescallSite = useClientANDapiVersion < 2025-02-19versions.** documents. Plugins and custom inputs built on it will ignore Content Releases.perspective: raw, the client sees drafts, published documents, and release versions.useClient set the correct apiVersion and perspective (2025-02-19 and raw respectively)”versions.** documents are not returned in API versions prior to 2025-02-19. You must opt-in to this version to query versions-prefixed documents.”