The DatoCMS JavaScript client is now fully type-safe. Records (the missing piece that wasn't) are also generated directly from your project’s schema.

This gives you real autocomplete and compile-time safety across your project.

The CLI bridges your schema and repo perfectly. Run a single command to generate types, and if your schema changes, rerun it to keep your code perfectly in sync.

$ npx datocms schema:generate schema.ts

The client also ships with new utilities to simplify record management, like duplicateBlockRecord(), inspectItem(), and mapBlocksInNonLocalizedFieldValue() to handle nested blocks, relations, and localized fields automatically.

Quick Links:

• CMA Client Package

• Configuring the CLI Docs

• Using the JS Client Docs

• Type-safe Development with TypeScript Docs

• Announcement post on the blog

You can now turn Structured Text fields back into Markdown with our new datocms/structured-text-to-markdown package. Perfect if you need clean Markdown output for your pipelines, exports, or tooling (or just a clean .md page for all the LLMs 🤭).

Just a lil

npm install datocms/structured-text-to-markdown

and you're set!

The renderer supports all DatoCMS Structured Text nodes and converts them to CommonMark-compatible Markdown:

Block Nodes

• Headings: # H1 through ###### H6

• Paragraphs: Plain text with double newlines

• Lists: Both unordered (-) and ordered (1.) lists with nested support

• Blockquotes: Lines prefixed with >

• Code blocks: Fenced code blocks with language support

• Thematic breaks: Horizontal rules (---)

Inline Formatting

• Strong: **bold**

• Emphasis: *italic*

• Code: `code`

• Strikethrough: ~~text~~

• Highlight: ==text== (extended Markdown)

• Underline: <u>text</u> (HTML fallback, no native Markdown)

Links

• Regular links: [text](url)

• Record links: Custom rendering via renderLinkToRecord

Full deets on the package and advanced usage are on the README.

We’ve fixed a long-standing issue with localized Link fields.

When editors used a Link field to reference entries, the dropdown showed records from all locales, even if those records were not available in the locale currently being edited. This often caused confusion in the UI, query errors and other unwanted production quirks.

Now, the Link field dropdown only shows records available in the current locale. This change should make managing localized content clearer and safer out of the box.

From now on, all API tokens — including the default non-editable tokens that are automatically created by DatoCMS — can be deleted.

Previously, default non-editable tokens (such as the read-only token) could not be removed. This change is a matter of security, giving you full control over your API tokens and allowing you to remove any unused or potentially exposed credentials.

💡 Reminder:
If you delete a default non-editable token generated automatically, it cannot be recreated. However, you can always create a new one with the same or custom permissions.

Many of you use shared Single Block fields to store common elements like title and image across models. Until now, these couldn’t be used as a model’s Presentation Title or Image — now you can!
You can now select a Single Block field in the Presentation tab, and DatoCMS will use the title and image set inside the chosen block as the model’s Presentation Title and Presentation Image.

How to use it

1. Go to Edit Model → Presentation tab

2. Select your Single Block field as Presentation Title or Presentation Image

3. Remember to set the presentation title and image you prefer in your Single Block’s own Presentation settings.

DatoCMS has long let editors organize records hierarchically. However, the feature was missing some elements to be considered as complete.

We covered the missing parts 💁‍♀️

• From today, a new "Tabular View" for trees of records is available - aside from the "Compact View", giving a bit more consistency on how records are visible across all model types. It brings all the freedom in playing with columns you know from the regular item list to hierarchically organized records too, without losing out on the drag-and-drop fun.

• We also removed the limitation to the number of records that can be organized in a tree: both the tabular and the compact view are now paginated, and records are incrementally shown as they are loaded.

To promote safer and more intentional permission management, new DatoCMS projects will no longer generate a default full-access API token (i.e. one with both read and write permissions for all APIs).

Previously, new projects came with two tokens by default: a full-access token and a read-only token. From now on, only the read-only token will be created automatically. This change encourages users to explicitly define the scope of each token based on their specific needs.

🔒 Reminder:
Existing projects still have this legacy token. If you’re using it, we strongly recommend ensuring it’s used only in trusted environments.

Starting May 14th, 2025, our legacy uploads batch operation endpoints — which have been deprecated for years — will be discontinued and will return error responses. Documentation for these endpoints can be found here:

• https://www.datocms.com/docs/content-management-api/resources/upload/batch_destroy

• https://www.datocms.com/docs/content-management-api/resources/upload/batch_add_tags

Required action

If you're using any of these endpoints, please update your integration to use their replacements. Documentation for the current endpoints can be found here:

• https://www.datocms.com/docs/content-management-api/resources/upload/bulk_destroy

• https://www.datocms.com/docs/content-management-api/resources/upload/bulk_tag

Impact assessment

Based on our monitoring over the last 30 days, no projects are actively using these deprecated endpoints.

We’re introducing a unified fixed header across all CMS sections, ensuring a smoother, more predictable interface.

What’s New?

We’ve standardized the header behavior so that key navigation elements stay accessible at all times—no matter where you are in the CMS.

• Fixed headers everywhere – The header now stays in place as you scroll.

• Consistent UI patterns – The same styling, spacing, and interaction logic apply across all sections, reducing cognitive load.

• Quick access to actions – Important buttons (like Save, Publish) remain within reach without unnecessary scrolling.

How Does It Work?

No setup is needed—just log in, and you’ll see the updated interface immediately!

Why Does It Matter?

This update eliminates inconsistencies, making the CMS more intuitive and reducing friction in your daily tasks. If you’ve ever lost time scrolling back up to access a button or felt disoriented by shifting layouts, this change will make navigation feel effortless.

With the release of the recent plugin its now possible to export JSON files of your models and blocks, and easily import them into another DatoCMS project.

To make it easier to get started with new projects and build out common schema models, we've released DatoCMS Recipes in the marketplace — a curated selection of ready-to-use models and blocks that you can import into your projects.

Simply choose a recipe, click install, choose which project you'd like it in, and we'll import the corresponding model with all blocks, relations, and plugins as required.

Want to create your own recipes? Install the plugin to export models and reimport them into another DatoCMS project!