Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

Highlights ✨

WebP all the things!

When using @sanity/image-url to generate image URLs, you can now automatically get WebP images if the browser supports it. Use auto(format) to make this happen.

Deleting assets in the asset browser

You can now delete assets in the asset browser. If an asset is used in other documents, we list them with a link to make it easy to remove the reference.

Features

• Syntax highlighting for Python, SASS and SCSS is now supported by @sanity/code-input. Thanks @longodj and @mmgj!
• If you have defined an icon for your content types, they will now be reflected in the editor for Portable Text’s Insert Menu.

Notable bugfixes 🐛

• Fixed a bug in the editor for Portable Text that threw an error when you had another editor inside a inline object type.
• Fixed a focus bug in the editor for Portable Text that would scroll to top trying to set focus further down in the document after going directly into fullscreen mode.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Rolled back keep-alive change in client that was causing asset uploads to fail

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

hasAlpha, isOpaque fields for images

Newly uploaded image assets now have two additional metadata fields:

• hasAlpha (bool) - Whether or not the image has an alpha channel (regardless of it being in use)
• isOpaque (bool) - Whether or not the image is opaque (does not contain any transparent pixels)

Note that these fields are only present on newly uploaded image assets.

Keep-Alive in Sanity client

The @sanity/client module now uses keep-alive ♻️ connections against the Sanity API. This improves performance when doing more than one request against the API within a short window of time by reusing network connections.

Filename field on code input

The @sanity/code-input plugin now has an option to enable a filename field. Set options.withFilename to true in order to enable this field. Thanks to Raymond Julin for this improvement!

🐛 Notable bugfixes

• Fixes a bug with Studio search that split words including numbers into separate terms
• Fixes a bug where deploying a GraphQL API would fail in certain conditions

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

It's now possible to remove all data for a rich text field

We used to leave an empty block object when you deleted all content in the editor for Portable Text. Now the field will be completely removed when you empty the editor for content.

Hoisted types can now be used as annotations

There was a bug in the schema validation that made it impossible to use types defined globally (also known as "hoisted types") as an annotation in a block type. Now you can refer to annotations types just as {type: 'myTypeDefinedElseWhere'}.

🐛 Notable bugfixes / changes

• Stack traces are now shown by default when errors occur in the Sanity CLI tool in order to more easily debug issues
• Fixed a bug for fallback deserialization of HTML links when pasting HTML into the editor for Portable Text without having the default link type in the schema.
• Fixed a bug where inserting inline objects in the editor for Portable Text would sometimes cause an error.
• The @sanity/code-input package was implicitly depending on an undeclared dependency
• Fixed a bug in @sanity/image-url where the crop parameter relied on the horizontal dimension where it should rely on the vertical

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fix bug where underlying request library would use HTTP for HTTPS proxy

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

Notable improvements

• Introduced HTTP(S) proxy support in the underlying request library for @sanity/client when using HTTP_PROXY / HTTPS_PROXY environment variables in Node.js

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fix failing builds because of breaking change in upstream dependency (terser)

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

This is mostly a maintainance and bug-fix release.

• Added schema validation rule for arrays where using unnamed object types in combination with the block type may lead to problems.

🐛 Notable bugfixes

• Fixed a bug where URL fields that allows relative URLs would be incorrectly be highlighted as having errors by the browser
• Fixed a bug in the portable text editor where starting a new document and pasting content as the first action would loose some of the pasted content
• Fixed issue where links in a default portable text block would not allow relative URLs
• Fixed issue where primitive values within an array that only allows object types would crash the form builder

📓 Full changelog

🐛 Notable bugfixes

This fixes an regression introduced in v0.140.0 that made it possible to reference draft documents. This caused issues when publishing drafts that other documents had references to.

📓 Full changelog

🐛 Notable bugfixes

This patch release fixes an issue with image uploads from the Content Studio in Safari/iOS

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

🎰 Reconfiguring studios

You can now easily reconfigure an existing Sanity studio project to use a different project ID and dataset, by running sanity init in an existing studio folder. This will take you through a reconfiguration process and update the sanity.json file.

You can also ship a "template" for a studio by leaving out the projectId and dataset configuration options in sanity.json - when a user runs sanity init or sanity start in a studio without these options set, it will take them through the creation or selection of a project and dataset.

⚖️ Improved studio search and experimental search config

This release introduces a way to define specific weights on fields/paths for document types.

Since the API is not stable yet, and likely subject to change, it's confgurable on the __experimental_search property for schema document types. Here's an example:

  type: 'document',
  name: 'author',
  fields: [
    {name: 'name', type: 'string'},
    // ...
  ],
  __experimental_search: [
    {weight: 1.2, path: 'name'}
  ]
  // ...

A few things to note:

• The weight is a global multiplier across all document types, so if name on type customer has a weight of 2, and name on type author has a weight of 4, documents of type author will be ranked higher than documents of type customer, even if their name fields equally matches what the user searched for.
• If no search config is specified on a document type, it gets derived from the preview config (which again is derived by default through schema introspection).
• We have also united the reference search with the global search, so that they both follow the same ranking/weighting rules.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Improved schema validation in certain scenarios
• @sanity/export no longer produces empty exports on subsequent calls

📓 Full changelog

🐛 Notable bugfixes

This patch release fixes an issue with selecting datetime values in arrays

📓 Full changelog

🐛 Notable bugfixes

This is a patch release to fix a problem with how block types are validated

📓 Full changelog

🐛 Notable bugfixes

• Fixed CSS build issues (for real, this time)

📓 Full changelog

🐛 Notable bugfixes

• Fixed a bug where a downstream dependency would cause CSS issues
• Fixed a bug where a downstream dependency would cause installation issues on Windows
• Minor bugfixes for the portable text editor

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

This is a maintenance release that fixes various issues introduced in in the previous release

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Realtime and customizable editor for Portable Text

The editor for Portable Text now supports real-time collaborative editing. Changes will be sent as small patches like everything else in the Sanity Studio. It is now also possible to customize the editor with your own styles, decorators and annotations,
and make your own toolbar buttons and previews for it. It also features better paste handling, block markers and actions.

Better tools for Portable Text

@sanity/block-tools have been updated to do a better job at converting HTML into portable text (blocks).
There are some breaking changes in this (mostly internal) package, so if you are using this module externally, have a look at the readme/changelog there.

🐛 Notable bugfixes

• Running the sanity command on Node v6 or earlier now gives a meaningful error instead of crashing
• Code input plugin now correctly registers its schema type once installed

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Node 8 required

In order to keep up with the Node ecosystem, we now require Node.js version 8 or higher in order to run the Sanity CLI. We will be updating the surrounding tooling to also require the same version over time. Node 6 has been out of active support from the Node.js foundation since the end of April this year, and upgrading from Node 6 is usually a drop-in replacement.

groq template literal package

You can now install and use the groq module in order to help identify GROQ-queries. When paired with editor extensions such as vscode-sanity, this allows for syntax highlighting of queries inside of JS-files. In the future, it might also do preprocessing of the queries, such as trimming unnecessary whitespace.

To use it, install it from npm:

npm install --save groq

And use it in your code:

import groq from 'groq'

const query = groq`*[_type == 'products'][0...10]`

Other features

• Optimized list panes so they don't render or sync contents when collapsed
• The reference select input now display correctly when in read-only mode

🐛 Notable bugfixes

• Fixed a bug where in some cases (often deep nested panes) stretches the last pane outside the viewport when having long titles in the header

📓 Full changelog