Contribute to this guide

CKEditor 5 changelog

This is the CKEditor 5 changelog guide. Here you will find information about the most important changes introduced in the release, new features, and bug fixes.

Information about both major and minor breaking changes is available, too, if the release introduces them. You can read more about breaking changes in CKEditor 5 in the Versioning policy guide.

You can find more information about each release in the blog posts linked at the start of each entry.

This guide provides the changelog information for the 3 latest releases of CKEditor 5. For older releases, refer to the release notes on GitHub.

# CKEditor 5 45.2.0 release

We are happy to announce the release of CKEditor 5 v45.2.0.

# Release highlights

CKEditor 5 v45.2.0 offers the following improvements and bug fixes.

  • We fixed the copy-paste scenario in the read-only mode.
  • Tables pasted from Office, especially with borderless layouts, should preserve styling in the editor similar to the ones in the source file.
  • Improved the adoption of the fullscreen feature on smaller screens and includes subtle visual tweaks.

# MINOR BREAKING CHANGES

  • source-editing: The formatHtml() helper function is extracted to the @ckeditor/ckeditor5-utils package. See #18480.

# Features

  • fullscreen: Empty sidebars will no longer lock empty space around the editable in fullscreen mode. Closes #18474. (commit)

# Bug fixes

  • engine: The editor should not crash while using Mac text replacement in the Track changes mode. (commit)
  • engine: Copying content in read-only mode should use the current document selection. Closes #18514. (commit)
  • engine: The editor should not crash after clearing content with a widget selected. Closes #18123, #18458. (commit)
  • pagination: Chrome no longer incorrectly pushes content to the next page when rendering documents consisting mainly of paragraphs with soft line breaks. Closes #7316.
  • paste-from-office: Unset table borders no longer fall back to default table styles. Closes #16931, #10655, #18540. (commit)
  • real-time-collaboration: Fixed a crash that occurred when a user selected table cells containing only non-textual elements, such as images.
  • revision-history: Fixed a crash in the revision history viewer that occurred when navigating revision changes, if the previewed revision was restored by one user but included suggestions originally made by other users.
  • source-editing: Single line pre-block should not cause loss of indentation on later lines in source mode. Closes #18360. (commit)
  • source-editing: Empty lines in code blocks should not be removed in source editing mode. See #18480. (commit)
  • source-editing-enhanced: Single line pre-block should not cause loss of indentation on later lines in source mode. Closes #18360. (commit)
  • source-editing-enhanced: Empty lines in code blocks should not be removed in source editing mode. See #18480. (commit)
  • table: Should apply the proper [width] attribute when it is used both on <table> and <figure> elements. Closes #18469. (commit)
  • track-changes: Fixed crashes that could occur in real-time collaboration when a user splits suggestions rapidly in a short time frame.

# Other changes

  • paste-from-office: Normalized pasted table length units (dimensions and border widths). (commit)
  • The development environment requires Node v22 due to migrating to the latest ESLint (v9) version. See #18475. (commit)

# CKEditor 5 45.1.0 release

We are happy to announce the release of CKEditor 5 v45.1.0.

# Release highlights

# Typing Improvements

The typing behavior has been improved for plain text typing. This adjustment allows the web browser to handle text insertion before the editor processes it, enhancing typing reliability across various scenarios, especially on Safari and iOS devices. Issues related to track changes, autocorrect, automatic text replacement, and other input methods have been addressed.

# Track Changes Enhancements

A new method to start a “tracking session” has been introduced, preventing automatic merging of adjacent suggestions. This allows for more precise control over individual changes, catering to workflows that require selective acceptance of edits.

# Miscellaneous improvements

  • Sticky toolbars and balloons are now better aligned with the visual viewport on iOS and Safari, ensuring correct positioning when zooming.
  • The fullscreen plugin has been improved to maintain scroll position when exiting fullscreen, avoiding unexpected jumps on smooth-scrolling pages. Layout consistency has been refined by adjusting margins and editable width. Errors related to the Content minimap plugin in fullscreen mode have also been resolved.
  • Introduced a fix which ensures that the data-author-id and data-suggestion attributes are preserved in non-block suggestions when retrieving data with showSuggestionHighlights: true.
  • We improved the algorithm for images detection in the Paste from Office feature, in scenarios of mixed local and online images from Microsoft Word. Paste no longer causes some images not to appear.

# MINOR BREAKING CHANGES

  • The default behavior of the beforeinput DOM events is no longer prevented in plain text typing scenarios. Now, the engine waits for DOM mutations and applies changes to the model afterward. This should not affect most integrations however, it may affect custom modifications to text insertion into the editor.

# Features

# Bug fixes

  • comments: Fixed a crash happening for some asynchronous collaboration integrations, when the TrackChangesData plugin was used while there was a resolved comment thread in the document’s initial data.

  • email: Fixed incorrect documentation links in the email configuration helper.

  • fullscreen: Minor styling improvements. Closes #18470. (commit)

  • fullscreen: Changed the method use to recognize the editor type in fullscreen. Closes #18395. (commit)

  • fullscreen: Fixed restoring scroll position after leaving fullscreen mode for containers with scroll-behavior: smooth. Closes #18378. (commit)

  • html-support: Removing formatting from empty HTML no longer crashes the editor. Closes #18089. (commit)

  • html-support: Pasting an empty HTML element no longer crashes the editor. Closes #18100. (commit)

  • image: Consume the .image_resize class and the [aspect-ratio] style during the upcast of the images. Closes #18287. (commit)

  • link: Fixed a bug where the editor would crash or do nothing when pressing the enter key in newline-suppressed scenarios (such as limit elements). Closes #15862. (commit)

    Thanks @jonscheiding!

  • minimap: The plugin no longer throws errors when entering the fullscreen mode. Closes #18472. (commit)

  • paste-from-office: Mixed local and online images from Microsoft Word paste no longer cause some images to disappear. Closes #18180. (commit)

  • source-editing-enhanced: When the Enhanced Source Editing dialog is open, all editor commands are now disabled to prevent accidental content edits and unintended UI interactions.

  • table: Table selector regarding margins should not override the style created during integrations. Closes #18428. (commit)

  • track-changes: Fixed insertion suggestion not restored on undo after it was rejected. This affected specific suggestions which included pressing the enter key. Closes #18449. (commit)

  • track-changes: Fixed a crash happening for some asynchronous collaboration integrations, when TrackChangesData plugin was used while there was a resolved comment thread in the document’s initial data.

  • track-changes: An empty element was incorrectly left when an insertion suggestion that ended on “enter key press” was discarded. Also fixed the same error in a case where a similar deletion suggestion was accepted. Related to https://github.com/ckeditor/ckeditor5/issues/18448.

  • track-changes: Added missing [data-suggestion] and [data-author-id] attributes to all suggestion types in editing and data pipelines.

  • typing: Typing in track changes mode no longer reverses typed letters in Safari. (commit)

  • typing: The Mac VoiceOver now reads typed characters when typing. Closes #15436. (commit)

  • typing: Mac text replacement shortcuts will now correctly replace text in Safari. Closes #13428. (commit)

  • typing: The list items and headings at the beginning of the editable area can be changed to a plain paragraph on backspace keypress. Closes #18356. (commit)

  • ui: Ensure the table properties form is fully visible within the viewport. Closes #16133. (commit)

  • ui: Optimized performance of dropdowns when opening with many items. Closes #18094. (commit)

  • The sticky toolbar and inline editor toolbar should maintain their visual position relative to the editing area, no matter the visual viewport scale or scroll in Safari on desktop and mobile devices. The contextual balloon position should be aware of the part of the top viewport offset visible in the visual viewport on Safari on desktop and mobile. Closes #7718. (commit)

# Other changes

  • core: Non-production license notifications should only be displayed once per page load. Closes #18179. (commit)
  • engine: Introduced the doNotFixSelection option for model.deleteContent() which can be used to force making deletion exactly on the provided selection. Closes #18448. (commit)
  • track-changes: Fixed an incorrect French translation in the Track changes feature.
  • typing: Improved typing performance in large documents. (commit)

# CKEditor 5 45.0.0 release

The CKEditor 5 v45.0.0 release brings powerful new features and improvements, making content creation smoother and more versatile. From enhanced email editing to a refined linking experience and a brand-new full-screen mode, this update is packed with valuable upgrades.

# Release highlights

# Email editing enhancements

We are making it easier to create and edit emails directly in CKEditor 5 with several enhancements. This release introduces the following new features:

  • Export with Inline Styles (⭐) provides the ability to export email content with automatically inlined styles, ensuring compatibility and proper rendering across different email clients.
  • Email Configuration Helper (⭐) is a new configuration helper plugin that provides guidance for integrators to correctly set up an email-friendly editor while avoiding common pitfalls.
  • Layout tables: are a new type of tables that has been introduced to simplify the creation of structured email designs, offering better control over layout, alignment and spacing.

Apart from these new features, this update also brings various fixes and improvements related to table behavior, enhanced HTML support, and better handling of complex email structures. These refinements help ensure a more seamless email editing experience, reducing inconsistencies and improving compatibility with external email clients.

# The fullscreen feature

A long-requested feature has finally arrived with the introduction of full-screen editing for the classic and decoupled editor types. This new mode provides a focused writing experience by making the editor the centerpiece of the screen. The expanded screen space allows for better visibility of content in sidebars such as comments, suggestions, and document outlines, enhancing your overall workflow.

# Improved linking experience

Linking in CKEditor 5 has been significantly upgraded with a redesigned user interface, making adding and editing links more intuitive. We added the possibility to add and edit the display text of a link. Users can now easily link to bookmarks within the document and select links from predefined lists (defined by the developer). These improvements make inserting and managing links faster and more flexible than ever before.

During this initiative, we also aligned visual and technical components of the editor. Each balloon got a header with the tile, we also unified the toolbar behavior and keystrokes of Link and Bookmarks with other widget’s toolbars like image and tables.

[!NOTE]
The UI got updated in several places: main view, link properties (decorators), and also its technical implementation changed. Make sure to give special attention to the update if you did any customizations to the link interface.

# New installation methods improvements: icons replacement

We are continuing to strengthen the new installation methods while phasing out older solutions. We added one of the key components you asked for: replacing our icons with your custom ones. It is now possible to replace the icons via the package’s override mechanism.

[!NOTE]
To achieve a proper solution for icons replacement for the npm builds, we needed to introduce a breaking change. If you used our icons for any purposes, make sure to update their paths.

# ⚠️ Deprecations in old installation methods: stage 1 completed

We are progressing with deprecation according to our sunset plan. From this release, predefined builds’ packages, such as @ckeditor/ckeditor-build-classic, are now officially deprecated.

We also dropped support for Webpack 4 in both the old and new installation methods. All packages and CDN from this version are now distributed with ES2022 as the target ECMAScript version, providing better compatibility with modern JavaScript features and improved performance.

By the end of 2025, custom builds that rely on webpack and DLL builds will also be deprecated. Refer to our documentation and migration guides to ensure a smooth transition.

We are committed to making CKEditor 5 even better. Stay tuned for more improvements in upcoming releases! If you have any feedback, let us know — we are always listening.

Please refer to the update guide to learn more about these changes.

Happy editing!

# MAJOR BREAKING CHANGES

  • bookmark: The BookmarkUI#actionsView is no longer available. The bookmark feature is now using the WidgetToolbarRepository instead.
  • build-*: CKEditor 5 predefined builds are no longer available.
  • link: The LinkUI#actionsView is no longer available. The bookmark feature now uses the LinkUI#toolbarView (an instance of the ToolbarView class) instead of the custom LinkActionsView.

# MINOR BREAKING CHANGES

  • link: The createBookmarkCallbacks() helper is now replaced by the isScrollableToTarget() and scrollToTarget() helpers.
  • table: The FormRowView class was moved to the @ckeditor/ckeditor5-ui package.
  • table: The form.css component was moved to the @ckeditor/ckeditor5-theme-lark package.
  • All CKEditor 5 icons are now available in the @ckeditor/ckeditor5-icons package.

# DISTRIBUTION CHANGES

  • All packages and CDN source code now target ES2022 as the ECMAScript version.

# Features

  • email: Introduced a new package to validate the editor configuration for email compatibility. It helps prevent misconfigurations by enforcing best practices and future-proof rules. Added utilities for post-processing CSS, improving support across various email clients by adjusting styles for better rendering consistency.
  • export-inline-styles: Added a new package for exporting content with inline styles. Ensures CSS classes ([class]) and IDs ([id]) are inlined within elements, improving compatibility with email clients that strip external styles. It helps maintain consistent formatting across different email clients, reducing rendering issues.
  • fullscreen: Introduced the fullscreen mode feature. Closes #18026. (commit)
  • html-support: Introduced the ability to render the<style> elements from the <head> section of editor data content using the FullPage plugin. See #13482. (commit)
  • revision-history: Added a new property RevisionHistory#isRevisionViewerOpen that indicates whether the revision history is opened or not.
  • source-editing-enhanced: The one-dark theme is now built-in and available via config.sourceEditingEnhanced.theme by passing the 'dark' value. This change enables the use of the dark theme with the CDN installation method, which does not support external CodeMirror dependencies. Additionally, if you previously used the oneDark extension directly, you can now switch to theme: 'dark' for built-in support.
  • table: Introduced the layout tables feature to enable constructing grids with tables, for example for email editing. These tables are designed for layout purposes, and include the role="presentation" parameter for accessibility. Users can insert layout tables via the editor toolbar and switch between content and layout tables. The editing view now closely matches the rendered output. Closes #18132. (commit)
  • table: Added the ability to toggle between content tables and layout tables. Users can switch table types using a split button in the table properties UI. While captions and <th> elements may be lost, table structure remains intact. Closes #18131. (commit)
  • table: Dragging and dropping a table into another table no longer merges them. Instead, the dropped table is placed as a whole inside the target cell. Pasting tables remains unchanged. Closes #18126. (commit)
  • template: Inserting a template containing a table into another table no longer merges them. Instead, the template is placed as a whole inside the target cell. See #18126.
  • theme-lark: Introduced the form.css component . (commit)
  • ui: Added the MenuBarView#disable() and MenuBarView#enable() methods. They disable/enable all top-level menus in menu bar. Closes #17940. (commit)
  • ui: Added the ToolbarView#switchBehavior() method to switch toolbar behavior after the editor has been initialized. Closes #18159. (commit)
  • ui: Introduced the FormRowView class. (commit)
  • Moved all icons to the @ckeditor/ckeditor5-icons package. Related to #16546. (commit)
  • Added the @ckeditor/ckeditor5-icons package to the core DLL package. (commit)

# Bug fixes

  • ckbox: Resolved an issue where images from private categories were not appearing in the selector. Closes #18044. (commit)
  • emoji: Fixed the emoji panel not being visible while used in comments archive. Closes #17964. (commit)
  • engine: The selection should not move to another table row while switching heading rows. Closes #17962. (commit)
  • heading: Added the missing converterPriority type definition to HeadingOption interface. Closes #18182. (commit)
  • html-support: The floated tables are now loaded and showed as expected in the editor’s view. Closes #18203. (commit)
  • link: The Autolink feature will now correctly autolink http://localhost and http://localhost:port. Closes #18185. (commit)
  • mention: Fixed the mention panel not being visible while used in comments archive. Closes #17964. (commit)
  • revision-history: Revisions will now correctly retain data for HTML embed widget, as well as <script> and <style> tags enabled by the General HTML Support feature. Before, when revision was saved, these elements were saved empty, and this lead to data loss when such revision was restored. Note, that this will not fix revisions that are already affected by this error.
  • revision-history: Fixed a crash when viewing a revision which had an HTML comment node in its data (reproducible with General HTML Support plugin).
  • revision-history: Fixed handling UIElements and RawElements by revision history (may concern third-party custom plugins).
  • revision-history: Fixed a crash when viewing a revision which had a collapsed marker in its data (may concern third-party custom plugins).
  • table: Removed [role="textbox"] from the <td>/` editables. Windows Narrator no longer reads table dimensions as 0 by 0. Closes #16923. (commit)
  • track-changes: The editor no longer crashes during initialization when the ShiftEnter plugin is removed.
  • ui: Do not open disabled menu bar menu items on arrow down press. Closes #17915. (commit)
  • ui: The ButtonView#icon property can now be set/reset after the button’s first render. (commit)
  • table: Widgets UI elements should be visible when they are inside tables. Closes #18268.
  • table: Nested tables outline should not be cut of at the bottom during hovering. Closes #18262.
  • link: Link balloon no longer disappears when scrolling the page slightly on iOS. Closes #18022.

# Other changes

  • bookmark: The Bookmark feature now uses the WidgetToolbarRepository instead of a custom ActionsView to display the bookmark toolbar in the contextual balloon. The new toolbar uses components registered in the ComponentFactory. (commit)
  • bookmark: Form styles and structure are now unified with use of ck-form and ck-form__row. (commit)
  • collaboration-core: Translations are now supported in the date formatter used by comments and suggestions, allowing for localizing dates.
  • engine: Added the read-only DomConverter#domDocument property. Closes #18146. (commit)
  • image: Image and custom resize form styles and structure now unified with use of ck-form and ck-form__row. (commit)
  • link: The link feature now uses the ToolbarView instead of a custom LinkActionsView to display the link toolbar in the contextual balloon. The new toolbar uses components registered in the ComponentFactory. (commit)
  • link: Form styles and structure are now unified with use of ck-form and ck-form__row. (commit)
  • real-time-collaboration: Added a more modern look to the presence list collapsed view (used when many users are connected to the document).
  • revision-history: The document outline will now be hidden when the revision history is opened.
  • source-editing: Document outline and annotations will now be hidden when editor is in source editing mode. Closes #17978. (commit)
  • table: Extracted the form.css to @ckeditor/ckeditor5-theme-lark package. (commit)
  • table: Extracted the FormRowView to @ckeditor/ckeditor5-ui package. (commit)
  • ui: The IconView now throws a meaningful error if the provided icon content is not a valid SVG. (commit)
  • widget: The WidgetToolbarRepository#register() now accepts a customized list of desired balloon positions. (commit)
  • Added the Belarusian language translations for CKEditor 5. Huge thanks to @karavanjo. (commit)
  • Upgraded the minimal version of Node.js to 20.0.0 due to the end of LTS. (commit)
  • Updated TypeScript target to es2022. Closes #17886. (commit)
  • Replaced lodash-es with es-toolkit. See #16395. (commit)
  • The @ckeditor/ckeditor5-build-* packages are no longer maintained. (commit)