Product Updates

DatoCMS changelog for new features and general improvements
Content Delivery API
New headers to specify environment and preview mode
June 10th, 2022

To make some room for future improvements to the GraphQL CDA, we're changing the way you can request content coming from sandbox environments and access records in draft.

The following GraphQL endpoints are now deprecated:

In favor of these new headers:

  • X-Environment: to explicitly read data from a specific environment;

  • X-Include-Drafts: to access records at their latest version available, instead of the currently published one.

Please note that these deprecated GraphQL endpoints will continue to work indefinitely, but we strongly suggest to only use as the GraphQL endpoint from now on. The documentation has been updated accordingly to reflect this change.

Content Management API
X-Api-Version header is required on new DatoCMS projects
May 31st, 2022

Up until now, if you did not provide an X-Api-Version header in your request towards the Content Management API, legacy API version 1 was used.

To avoid ambiguity and possible unexpected problems, we have decided to change this behavior on projects created from this point on:

  • if your project was created before 31 May 2022, 13:00:00: not explicitly passing the X-Api-Version header will default to CMA API version 1 — nothing changes;

  • if your project is created after 31 May 2022, 13:00:00: not explicitly passing the X-Api-Version header will result in an error and a 422 Unprocessable Entity status code.

Content Management API
Minor changes to CMA site endpoint response
May 24th, 2022

Starting from May 30th, 2022 10:00 CEST:

The site resource object returned by the CMA will no longer expose the following properties:

  • attributes.frontend_url: this was deprecated years ago in favor of multiple build triggers per project;

  • relationships.menu_items: use the dedicated endpoint to retrieve the list of menu items;

  • relationships.users: use the dedicated endpoint to retrieve the list of collaborators;

  • relationships.sso_users: use the dedicated endpoint to retrieve the list of SSO users;

  • relationships.roles: use the dedicated endpoint to retrieve the list of roles;

  • relationships.build_triggers: use the dedicated endpoint to retrieve the list of build triggers.

Content Management APIContent Delivery API
Improved timezone management
May 17th, 2022

Today we're switching to a better management of timezones in datetime values stored in your projects!

Current behaviour

DateTime fields in your records do not carry timezone information.

If you use the Content Management API to create/update a record, and you provide an ISO8601 datetime complete with timezone to a DateTime field, the timezone part is completely ignored by the system. Just the date + time information will be stored in the field value, and the project timezone will be automatically applied to it when the API outputs the value.

const record = await client.items.update('324342', {
dateTimeField: '2000-01-01T09:30+10:00',

In this example, if the timezone setting in your project is Europe/Rome, the returned datetime won't be 2000-01-01T09:30+10:00, but 2000-01-01T09:30+01:00 .

Also, if you change the timezone setting in the future to be ie. Pacific Time, the same date will immediately become 2000-01-01T09:30-08:00, and every other date stored in your records' fields will change similarly. This basically has the effect of moving dates in time.

Improved behavior

DateTime fields in your records DO carry timezone information with them.

The only effect of the global timezone setting is to return via API every datetime value coherently converted in the same timezone.

Following the same example used above, if the timezone setting in your project is Europe/Rome, and you update a datetime field value passing 2000-01-01T09:30+11:00, the datetime returned by the API will be 1999-12-31T23:30+01:00 — that is, same point-in-time, but expressed in the project timezone.

If you change the timezone setting in the future to be ie. Pacific Time, the same date will immediately be presented via API in the new timezone (1999-12-31T14:30-08:00), but the point-in-time will be kept intact.

Who is affected by this change?

Every brand new DatoCMS project created starting from today will be under the improved behavior. If you want to switch your existing project to the new behavior, you can manually do so in the Environment Settings:

PS: Be aware that the change cannot be undone, so be sure to test the effects in a sandbox environment before applying the change to your primary environment!

UI Improvement
Resend email invitation to collaborators
April 29th, 2022

Sometimes the invitation email to participate in a project can get lost. In these cases, you can now send a new invitation email from the Collaborators section:

UI Improvement
Add new locale by copying content from the main one
April 28th, 2022

A new modal is now displayed when adding a new locale on a record, to ask if you want to copy the content present in the main language:

UI Improvement
Keyboard shortcuts for saving and publishing records
April 27th, 2022

A welcome addition to speed up the editing of records:

  • Cmd/Ctrl + S saves the record

  • Cmd/Ctrl + Shift + S publishes the record

If you have other shortcuts to suggest, we're all ears!

UI Improvement
A better datetime field editor
March 2nd, 2022

We're happy to announce that we've completely rewritten the datetime component to make entering dates more intuitive, especially for teams that are in different timezones.

The first thing you'll notice is the timezone information, which is now always visible next to the date itself:

For added convenience, each user will always see dates converted into their system timezone, regardless of the project timezone setting.

You can always change your default timezone preference in the localization settings:

Another welcome change (we hope) is time shortcuts — ie. just type 15<Tab> and the system will interpret it as 15:00:00. We also got rid of the time selector dropdown, as it was rather annoying to work with:

UI Improvement
Used blocks count indicator
March 2nd, 2022

Especially in projects with a large number of locales, it's important to keep an eye on the number of blocks used within a specific record, to avoid exceeding the limits on your plan.

We made a small change to the interface to display a bar showing the current usage of blocks. The same information is also present in the sidebar:

UI Improvement
Easily regenerate slugs on existing records
March 1st, 2022

One tiny addition that may save a few seconds every day: we added a button on slug fields to regenerate the value of a slug.

A video is worth a thousand words in this case: