●Change8

Migrating to Netlify CMS decap-cms@3.12.0

Version decap-cms@3.12.0 introduces 1 breaking change. This guide details how to update your code.

Released: 4/16/2026

1
Breaking Changes
1
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

markdown widgetrichtext widgetwidget-objecti18n entriesfrontmatter

Breaking Changes

●Issue #1

The markdown widget has been replaced by the new richtext widget. While intended as a drop-in replacement, users should test thoroughly as some edge cases from the old markdown widget might not be covered by the new richtext widget (which is currently beta).

Migration Steps

  1. 1
    Review usage of the markdown widget and test integration with the new richtext widget, especially for edge cases.

Release Summary

This release introduces the highly anticipated richtext widget as a beta feature, replacing the markdown widget, alongside several performance improvements and bug fixes related to pasting and error handling.

Need More Details?

View the full release notes and all changes for Netlify CMS decap-cms@3.12.0.

View Full Changelog