Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

Fixed a bug that resolved wrong array input for toplevel array types

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixed sanity init sometimes exiting before completion on Windows
• Fixed a rare case where listeners would get invalid unicode sequences in messages on Node.js
• Fixed a missing dependency in @sanity/base (thanks @XslemX!)

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

Fixed a bug that could cause the studio to crash when encountering images with either hotspot or crop but not both (#923)

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

Get a list of Sanity projects in the command line

Some of us have acquired quite a few Sanity projects and for sure manage.sanity.io has the list, but who has time to open a browser? So now you can $ sanity projects list in your command line of choice, and get a fine responsive table of all your projects with their IDs and studio URLs for your logged in user.

🐛 Notable bugfixes

Order list of documents by fields on referenced documents (#908)

The sort orders now support ordering by a field on a referenced document, e.g.

// on book schema where author is a reference to an author doc
orderings: [
  {
    title: 'Author name',
    name: 'authorName',
    by: [{field: 'author.name', direction: 'asc'}]
  }
]

Arrays now tolerate items with missing keys (#919)

Quashed a bug that made the Content Studio crash when opening a document that had an array field where one or more items were missing a _key. This is now handled, and the user is presented with a way to quickly set keys on items that lack it.

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

"Clean" project template

If you've tried out Sanity before and know how the schemas fit together, it can be nice to bootstrap a new project without any existing schemas. We've (re)introduced this feature to the CLI!

Asset metadata extraction on per-field basis

The Sanity asset backend can extract and generate metadata from images - things like GPS location, exif data, low-quality image placeholders, palette information and similar. You may now specify which data you want to extract on a per-field basis in your schemas. For more information on this feature, see the documentation.

Create and delete documents from the command line

You can now create and delete documents from the command line with sanity documents create myDocument.json and sanity documents delete <document ID>. You can also create a new document from your favorite text editor by running sanity create document and have Sanity watch for changes with sanity document create --watch. Check the documentation for more infomation about these features.

🐛 Notable bugfixes

• Datepicker does not close when choosing a date 🐞
• Datepicker allows edit the date inline 🐛
• The CLI tool would sometimes take very long to respond because of an update check that was blocking execution. This update check now has a timeout before proceeding.
• Reference fields now correctly displays any validation errors.
• Passing a transaction instance created outside the scope of a Sanity client to the mutate() method now serializes the transaction correctly.

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

Various visual fixes and a few bugfixes

🐛 Notable bugfixes

Fixed a bug with sanity export causing custom image/file fields (e.g. caption) to be lost in exported files

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

🚜More reliable import

The sanity dataset import CLI command is now more fault tolerant, retrying in the case of network failures and similar (up to a maximum number of retries, obviously).

➡️Pass arguments to sanity exec scripts

You can now pass arguments to scripts executed through sanity exec by using subargs:

sanity exec --with-user-token -- --your-script --flags=here

👻 External CSS without CSS modules

When using third-party React components and want to import related CSS files, Sanity will by default convert the CSS to CSS modules. This won't usually work as expected, since the class names change. To force Sanity to use unprefixed CSS classes, you can import using the raw query parameter. For instance:

import 'some-react-component/styles.css?raw'

See PR #849 for more background information.

🐛 Notable bugfixes

• Fix a bug where selecting a paragraph style from within a dialog would close the dialog
• The block editor will no longer crash when selecting a block from an array without any text blocks
• The --visibility flag on sanity dataset create now actually works 😳
• @sanity/image-url can now parse full asset URLs, enabling you to add image transformation parameters to the URL programatically.

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

Fixed a bug causing the delete button on array items to not respond to mouse clicks

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

This is a bugfix and maintenance release and includes several improvements and stability fixes

✨🐞 Notable improvements and bugfixes

• Not displaying delete button when editing "empty" array items, instead showing "cancel" (#810)
• Fixed a bug when drag-drop batch uploading images that caused an edit dialog to pop open for the last array item (#811)
• When deleting array items, the confirm delete button is now focused by default, and focus is properly restored to the item when closing it (#783)
• Fixed a bug causing text selection on Safari when dragging to reorder array items (#814)
• Fixed various dialog sizing issues (#809, #815)
• Upgraded RxJS to 6.1 and deprecated the @sanity/observable package (#768)
• Upgraded react-json-inspector (#821)
• Fixed a race condition that would sometimes display a document as deleted (for a brief period) when publishing it (#822)
• Fixed a bug causing the style select to not pop up when editing block text in fullscreen mode (#823)
• The studio base path can now be overridden using an environment variable. Thanks @dan-dr for putting this together! (#819)
• The studio will now switch to responsive mode when resizing (#807)
• Fixed a bug causing editing of inline objects to fail (#826)
• Fixed an issue where buttons got wrong spacing in some cases (#824, #825)
• Improved detail level of error messages on import failures (#831)

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixed a bug causing ecommerce studios to fail on first deploy

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixes a bug causing the add-button on array of primitives to not work

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

⌨️ CORS management through CLI

The command line tool now allows you to manage CORS origins without going through the management interface: sanity cors add, sanity cors list and sanity cors delete are your new friends!

📭 Removing empty values

A common complaint has been that "empty" array items sometimes keep hanging around. For example, if you add an item to an array, then closes the add dialog immediately, then the added item was not removed again. This has now been fixed, and if array items are empty when the edit dialog is closed, the item will be removed from the array (see #780 for more details).

🗑 Dropping React 15 support

We launced with React 16 support as of v0.127.0, which was released two months ago. Since then, we have been developing against React 16.2, and since tracking usage of React 16 specific features is hard, we have decided to make it explicit that the studio needs React 16.2 or newer to run. In case you missed it, here's how to upgrade React in your Sanity studio.

🍱 Use layout: 'grid' on your array of images

Make an array look more like an image gallery. Just add options: {layout: 'grid'} to your array. Uses CSS Grid layout to autosize the columns.

ProTip: You can use the layout: 'grid'-option on arrays of any type, not only images.

🗝 Part-ify rendering of login providers

You can now take complete control of how your Studio renders your login providers. Create your own implementation of the LoginDialogContent.js component. Then wire it up in sanity.json:

{
  "implements": "part:@sanity/base/login-dialog-content",
  "path": "MyLoginDialogContent.js"
}

🐛 Notable bugfixes

• Improved display of the tokenized tags input in readOnly mode
• Fixed a bug causing errors when geopoint types were used in an array
• Fixed a bug causing the sanity command to complain about incompatible version for prereleases
• Fixed a bug causing preview components to erroneously identify numbers and empty values as invalid preview values

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixed bug where sanity upgrade would fail to upgrade modules because of inexplicable yarn bug

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

E-commerce sample schema

Till now when you have set up new projects with sanity init you have had the choice between a film database and blog to provide examples of how well known data structures are modeled in Sanity. Now we've expanded this to an e-commerce example.

For an example frontend to use with this schema, check out our Vue/Nuxt.js based ecommerce example frontend

If you don't like blogs, movie databases or e-commerce you can always just:
sanity init --template clean

Error boundaries

If something inside of a tool crashes during rendering, a more user-friendly error message will be displayed.

Default input for date strings

We already had a default input for datetime types, now we also have an input for plain dates (as in date strings without a time segment, e.g. 2018-05-03)

Better feedback on invalid preview config

We have received quite a few error reports that have been caused by invalid values returned from the preview config. Instead of a hard failure in the Studio, these errors should now be handled more gracefully along with a detailed explanation in the developer console.

Node v10 compatibility

Initializing and running a Sanity Studio locally on Node v10 should now work.

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixed a bug that could cause the published document to get overwritten by an empty draft when publishing using the hotkey.

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixed a bug causing sanity init to fail when resolving dependencies in Node.js 10

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

🐛 Notable bugfixes

• Fixed a bug where sanity start would crash if NODE_ENV was to production

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

Publish without confirmation

We've removed the extra confirmation step after pressing the publish button. This after feedback that it was mostly annoying and very seldom helpful.

Live Edit

Even though the Content Studio saves your document as you are typing you typically need document changes to be buffered in drafts before you publish them. Sometimes though you want your changes to be immediate. We have therefore added the option liveEdit: true to the document schema type. This does away with drafts and makes every document change reflect on the APIs and show up for listeners as mutations.

Migrations

The best way to run migrations is by writing a small JavaScriptlet that you execute using sanity exec. In this release, we have added support for passing --with-user-token to sanity exec, which will allow you to import a preconfigured, authenticated client from part:@sanity/base/client in your script. Our documentation also now covers running migrations.

🐛 Notable bugfixes

• Fixed a bug that allowed field names with invalid characters, causing invalid queries (#434, #748)
• Fixed a bug causing Safari to report valid urls as invalid (#751, #752)

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

📓 Full changelog

Upgrade with:

sanity upgrade

And install the latest Command Line Interface (CLI) with:

npm install --global @sanity/cli

✨ Highlights

Import from folder

You may now target a folder when using sanity dataset import. It will look for an ndjson file within the directory. This is useful when extracting a tarball exported with sanity dataset export to a folder and changing its content.

Studio on non-root paths

When hosting the studio yourself, you may want to put it on a non-root path in order to serve a website and the studio from the same domain. This is now supported by specifying a basePath property under the project key of your projects sanity.json file. Example:

{
  // ...
  "project": {
    "name": "Movies studio",
    "basePath": "/studio"
  },
  // ...
}

🐛 Notable bugfixes

• Unicode URLs are now treated as valid URLs
• The image-url module now properly supports passing a document ID, a reference or a materialized asset document (thanks @enigosi!)

📓 Full changelog