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.
We are happy to announce the release of CKEditor 5 v48.1.0.
This release improves AI Chat formatting and rendering, introduces experimental AI support for multi-root and multiple editor setups, and strengthens compatibility with structured content pasted from Office and exported for email.
AI Chat now handles raw, unformatted content more reliably. Asking AI Chat to format a pasted transcript, add headings, or convert content into a list produces cleaner and more predictable results.
The AI Chat feed also renders generated content differently. Proposed changes now appear in full when they are ready, while plain assistant text continues to stream at a faster pace.
AI features now support multi-root editors and multiple editor instances that share a Context. This helps integrations that use several editor areas on one page, such as a title, body, sidebar, or document sections split into independent roots.
With this release:
- AI Review and AI Translate run across all roots in a multi-root editor and across all editors that share a
Context. Changes are applied to the related root or editor. - AI Chat uses content from the focused root or editor, applies suggestions to the related destination, and keeps separate conversation history for each editor in a
Context.
This feature is experimental and ready for testing in multi-root and multiple editor integrations.
This release also includes several improvements for content editing, Office content compatibility, and email output:
- Marker boundary elements registered with
markerToElement()now render in the same order as in the model when two markers meet at the same position. This affects features that rely on markers, including comments, suggestions, mentions, find and replace, and restricted editing. - Inline formatting such as bold, italic, font size, font family, font color, and background color is now retained after pressing Shift+Enter twice or after deleting all text inside a block and continuing to type.
- Source Editing now supports native undo and redo keystrokes in the source editing textarea.
- The editor now handles alignment attributes on
<td>elements that wrap nested tables or images. This improves compatibility with content from Outlook and other sources that usetd[align]for block layout. - Tables now preserve their alignment and inline styles after the email export transformation, improving rendering in Outlook, Gmail, and other major email clients.
-
ai: AI Chat feed items are now aligned to the bottom of the feed by default. To restore the previous top-aligned behavior, add the following CSS to your integration:
.ck.ck-ai-chat__feed__items { margin-top: 0; }Copy code -
ai: AI Chat suggestions proposed by the agent are now displayed in full when ready. Previously, they streamed word by word.
- core, editor-balloon, editor-classic, editor-decoupled, editor-inline, editor-multi-root, engine: Introduced
config.root.modelElementfor single-root editors andconfig.roots.<name>.modelElementfor multi-root editors, allowing integrators to configure the model root element type. Added the$inlineRootgeneric schema item for use with the new editor configuration. Closes #20029. - core, editor-balloon, editor-classic, editor-decoupled, editor-inline: Enabled the
modelAttributesroot configuration option for all single-root editors. - ai: Added the opt-in
config.ai.container.collapsibleconfiguration option. When enabled, clicking the active tab button toggles the.ck-ai-tabs_collapsedCSS class on the.ck-ai-tabselement. The option defaults tofalse. - ai: The
AIChatController#startConversation()method now accepts an optionalmodelIdparameter to select a specific model for the new conversation. Custom Quick Actions of typechatwith amodelproperty will now use it when starting a chat conversation. - ai: AI Review and AI Translate now support multi-root editors and multi-editor-instance contexts.
- ai: AI Chat and AI Chat History now support multi-root editors and multi-editor-instance contexts.
- document-outline: Added the
tableOfContents.headingsoption that lets integrators choose which heading levels appear in the Table of Contents widget independently from the Document Outline sidebar. - email: Added support for restoring the
alignattribute on table cells during email transformations when all child elements of a cell share the same alignment. This produces more compact HTML and improves compatibility with legacy email clients. See ckeditor/ckeditor5#19883. - export-inline-styles: Added the
runAfterDocumentTransformationandrunAfterChildrenTransformationcallbacks. They allow integrations to defer transforming selected elements until their children or the full document has been processed and their styles inlined. - format-painter: Added an ARIA live announcement when the user cancels format painting by pressing the Escape key.
-
code-block, emoji, mention: Mention autocompletion (and features built on top of it, such as slash commands and emoji) no longer triggers inside code blocks. Closes #19146.
-
engine, enter: Fixed document selection attribute inheritance around
<softBreak>so returning the caret after a soft break restores formatting. Closes #19853.When selection attributes are recalculated across
<softBreak>, only attributes marked withcopyOnEnterare inherited. Other inline non-object elements still act as hard boundaries. -
engine, enter: Inline formatting attributes (such as bold or link) are no longer split by a soft break (
<br>). The<br>element now inherits applicable text attributes so that attribute elements in the view can wrap around it without being broken into separate segments. Closes #1068. -
show-blocks, table: Improved the performance of show blocks and table selection styles in large documents. Closes #20058.
-
ai: Fixed a bug where the AI Quick Actions balloon selection marker was incorrectly included in the AI Chat context.
-
ai: Custom Quick Actions of type
actionwithout amodelproperty now fall back to the default model from theai.models.defaultModelIdconfiguration or the first available model. Previously, they failed with a400backend error. -
ai: Fixed formatting of larger unformatted content in AI Chat.
-
ai: Fixed flickering and stuttering in the AI Chat sidebar.
-
ai: AI Review no longer throws an error when running review commands if the editor content contains a multiline code block.
-
ai: Fixed a bug where custom MCP tool context item chips displayed a UUID instead of the human-readable label after reloading a conversation from history. The label is now preserved during serialization so it survives the server round-trip.
-
ai: Undoing AI changes after starting a new chat no longer throws an error.
-
ai: Moved the “New Chat” button from the empty tab view to the AI Chat History tab header.
-
ai: Added a dedicated “Maximize” button to resize AI Translate and AI Review tabs.
-
ai: AI Chat commands (Explain, Summarize, Highlight key points) no longer prevent the AI from performing document edits in follow-up messages.
-
ai: Improved AI Quick Actions accessibility by disabling the dropdown and menu bar in AI Review. Closes ckeditor/ckeditor5#8932.
-
ai: Fixed AI Chat feed items not sticking to the bottom of the feed when the AI Chat shortcuts feature was not loaded.
-
ai: Fixed editing chat names in AI Chat History. The input state is now restored after canceling, and failed save attempts no longer update the local chat name.
-
ai: Fixed a crash when the AI proposes unwrapping content (e.g., removing blockquotes while keeping their inner content).
-
ai: Removed hover states from non-interactive tiles in AI Chat. Only actionable tiles now show hover feedback.
-
ai: Updated suggestion styling in AI Chat. The suggestion box now has a distinctive border, and its header no longer has a shadow.
-
ai: AI Review and AI Translate results are now shown from the beginning on subsequent runs. Previously, the scroll position was preserved.
-
ai: Fixed AI Chat responses that ignored parts of content proposed by the AI model, for example when removing a paragraph instead of wrapping it in a block quote.
-
ai: AI components now fall back to default styles when the
container.type: 'custom'configuration option is used. -
ai: Wide content, such as tables, inside AI suggestions no longer overflows its container. The container is now horizontally scrollable.
-
ai: Fixed a stray ellipsis (
…) artifact that remained painted next to the rename input when editing a long chat name in the AI Chat history. -
comments: Fixed annotation ordering when creating a comment while the target text is scrolled out of view. Previously, the sidebar could break, and other annotations could flicker due to stale position data used for ordering.
-
comments: Fixed a regression where the editor lost focus after resolving a comment thread from the narrow sidebar.
-
comments: Pressing Tab to confirm a mention suggestion in a comment editor no longer shifts focus to the Submit/Reply button.
-
editor-classic: The classic editor no longer throws an unclear error when initialized with a source element that is not attached to the DOM. A dedicated
editor-source-element-not-attachederror is thrown instead. Closes #20017. -
email: Preserved nested table alignment when exporting with inline styles.
-
email: Fixed table alignment handling for tables with and without text wrapping. This applies when the
table.tableLayout.stripFigureFromContentTableoption is set tofalseand thePlainTableOutputplugin is not included. Tables now keep their alignment, dimensions, and styling. -
email: Fixed
figcaptionwidth and overflow issues in exported table figures. When exporting a table wrapped in afigure, itsfigcaptionno longer receives an incorrect width and stays within the bounds of the exported element. Captions withcaption-side: topare now positioned immediately before the table. -
emoji: The emoji panel now renders on narrow screens. Closes #18552.
-
engine: Fixed the editing downcast order of adjacent marker UI boundaries so marker ends and starts are rendered consistently with the model and data output. Closes #19975.
The editing pipeline now produces a deterministic marker order and preserves the expected boundary order when adjacent markers are added together or when the second adjacent marker is added later.
-
engine: Preserved formatting, such as bold or italic, after deleting content that empties a block so that typing continues with the same formatting. Closes #10517, #19777.
-
fullscreen: Fixed errors that could appear when maximizing the AI panel after leaving fullscreen mode. Closes #20129.
-
horizontal-line: Horizontal lines (
<hr>) placed next to each other no longer collapse their margins in the rendered output. -
html-support: The definition list (
dl) no longer breaks the structure of the list when it is placed within a list item. Closes #20067. -
list-multi-level: Fixed a stale multi-level list marker appearing on a block widget (e.g., a table) after a paragraph was inserted before it as the first block of the same list item.
-
paste-from-office: Fixed incorrect structure of nested lists pasted from Word when plain paragraphs appear between nested list items. Closes ckeditor/ckeditor5#19127.
Previously, all paragraphs were placed after the nested list items instead of between them. The fix also ensures that interrupted nested ordered lists continue numbering across the paragraph breaks.
-
paste-from-office: Pasting content from Word no longer inserts unwanted visible bookmarks into the editor. Closes #18846.
-
paste-from-office-enhanced: When pasting from Excel, cells with patterned backgrounds now keep their colors.
-
paste-from-office-enhanced: When pasting bulleted lists from Word, the correct bullet style (disc, circle, square) is now preserved instead of defaulting to disc.
-
real-time-collaboration: Fixed an error thrown when
editor.destroy()was called right aftersaveRevision()in a real-time collaboration session. -
revision-history: Fixed revision history sidebar grouping for revisions from the same time period, such as the same year.
-
slash-command: Slash commands no longer trigger inside code blocks, because code blocks are designed to contain plain, unformatted code where autocompletion is not applicable. Closes ckeditor/ckeditor5#19146.
-
slash-command: Fixed translation of list item titles (“Bulleted List”, “Numbered List”, “To-do List”) in the slash command panel by aligning translation keys with those defined in the list package.
-
source-editing: Native undo/redo keystrokes now work in the source editing textarea. Closes #13700.
-
table: Improved how table cell alignment is loaded into the editor. Previously, applying alignment to a cell could force text alignment on all nested elements inside it. Now, alignment is applied to the direct contents of the cell without breaking the layout of deeper nested content. Closes #19883.
-
ui: The menu bar no longer stays open after clicking the “Fullscreen mode” menu item when entering fullscreen mode. Closes #20056.
-
uploadcare: Fixed a build error affecting some TypeScript projects using Uploadcare integration. Closes ckeditor/ckeditor5#19692.
-
uploadcare: Uploadcare-uploaded images no longer render blurry when their natural width falls between the responsive
<source srcset>breakpoints. The generated srcset now always includes a variant at the original (or cropped) image width as its largest entry, so the browser can serve a 1:1 pixel match instead of upscaling a smaller variant.
-
ai: Updated the message displayed in AI Chat when you click the “Stop generating” button after sending a prompt.
-
ai: Improved content streaming performance and rendering in AI Chat and AI Quick Actions.
- AI Chat now displays individual suggestions only when they are ready and shows a skeleton loader while waiting for the next suggestion.
- AI Chat and AI Quick Actions now use smooth scrolling.
- AI Chat and AI Quick Actions now stream word-by-word responses faster.
-
core: Added the
RootConfig#descriptionconfiguration property. It lets integrations identify editor roots when using multiple editor instances on one page or a multi-root editor. Closes #20119. -
engine: Added the
ViewDocument#getRoots()method, a convenience accessor returning all view roots as an array (analogous toModelDocument#getRoots()). Closes #20097. -
list: Prevent list attributes from being applied to text nodes and inline objects during content insertion, which could crash the editor when a permissive
Schema#addAttributeCheck()is used. Closes #19994. -
track-changes: Improved Track Changes performance for lists. Previously, the browser could freeze when many list suggestions were added to the document at once.
We are happy to announce the release of CKEditor 5 v48.0.1.
The release addresses a vulnerability identified in the protobuf.js package (CVE-2026-41242), used within our @ckeditor/ckeditor5-operations-compressor package for real-time collaboration.
Our analysis confirms that this vulnerability does not affect CKEditor 5, as all protobuf definitions are static and pre-compiled at build time, and are never parsed or compiled from untrusted input at runtime - which is the condition required to exploit this issue.
This release primarily aims to ensure that our customers using real-time collaboration features do not encounter unnecessary security alerts from their scanning tools. We are committed to maintaining the highest security standards, and this update reflects our ongoing efforts to safeguard user environments proactively.
We are happy to announce the release of CKEditor 5 v48.0.0.
CKEditor 5 v47 remains the LTS release. If you are an LTS customer, stay on this version. The next releases in the v47.x line will be published for LTS customers only.
This major release improves CKEditor AI and tables, completes the sunset of old installation methods, changes the default Export to PDF converter API version, and introduces a unified structure for root-related configuration.
With this release, we have officially completed the transition to our modern installation methods — a milestone we are excited to reach! 🎉
First introduced in CKEditor 5 v42.0.0 in June 2024, these new methods were designed to simplify the developer workflow, reduce configuration overhead, and unlock faster, more consistent updates. With the old methods now fully retired, we can focus all our energy on delivering new features, improving performance, and moving the platform forward.
If your project still relies on old installation methods, migrate to the new installation methods to continue updating to this and later versions of CKEditor 5.
If migrating in the near term is not feasible, you can extend support for legacy installation methods with CKEditor 5 Long Term Support (LTS).
The styling of suggestion previews in AI Chat, AI Review, AI Quick Actions, and AI Translate now more closely matches the content in the editing area, providing a more consistent visual experience. Initialization has also been optimized by caching model requests, reducing redundant network calls.
Colors used across the AI package are now available through a shared CSS variable palette, making AI components easier to customize. A new programmatic API guide also describes how to interact with AI features from code.
We are introducing table alignment, giving users and integrators much more control over how tables are positioned relative to surrounding content. Tables can now be aligned left, or right with proper text wrapping — a feature well-known from CKEditor 4 that many users have been requesting.
Table alignment now uses CSS margin-based positioning by default, producing cleaner output. With a configuration option, teams which are migrating from CKEditor 4 can switch the output back to inlinse styles if needed.
We are also introducing the ability to switch table cell types between header (<th>) and data (<td>) in the Cell Properties panel.
Additionally header cells can be associated with related row or column with the scope attribute using the “Row header” or “Column header” options. These options help screen readers understand the table structure.
The editor now recognizes legacy HTML table attributes during upcasting, preserving styling from older HTML content and improving compatibility with CKEditor 4.
- The
<table border="N">attribute is now converted totableBorderWidth. - The
<table cellpadding="N">attribute is now converted totableCellPadding.
Several default table behaviors have also been updated:
- Conversion of
border="0"to borderless tables is now enabled by default. - Table alignment is now output as CSS classes by default. Using inline styles is still possible with the
useInlineStylesoption. - Support for the
scopeattribute in table header cells is now enabled by default. - Added support for table footers, thanks to a community contribution from @star-szr.
The Export to PDF feature now defaults to version 2 of the converter API, so you will enjoy a range of powerful enhancements right out of the box — including advanced header and footer configurations, flexible page sizing, PDF metadata editing, owner password protection, and digital signature support.
Since the new version may produce slightly different output than version 1, we recommend reviewing the new default configuration.
If you need to keep the previous behavior, simply set the version property in the exportPdf configuration object. See the feature documentation for full details on both API versions.
Editor configuration options related to roots, such as initialData, placeholder, and label, are now grouped under config.root for single-root editors and config.roots for multi-root editors. This provides a more consistent structure for configuring editor roots.
The previous top-level configuration options remain functional but are now deprecated. See the update guide for migration details.
Please refer to the update guide to learn more about these changes.
-
ai, uploadcare: Simplified AI and Uploadcare configuration structures by replacing enums with plain string values. Refer to the official updating guide for AI and Uploadcare.
-
ai: Renamed the
checkproperty tocommandIdin theai.chat.shortcutsconfiguration. Refer to the official updating guide. -
ai: Introduced the
labelproperty in place ofdisplayedPromptin theai.quickActions.extraCommandsconfiguration. ThedisplayedPromptproperty is now required only for extra commands with type'chat'. Refer to the official updating guide. -
ai: Changed the
typeproperty values in theai.quickActions.extraCommandsconfiguration from uppercase to lowercase. Refer to the official updating guide. -
editor-multi-root: The
config.rootsAttributesandconfig.lazyRootsmulti-root editor config options have been removed. See #19885.The
config.rootsoption should be used instead to define the editor roots and their attributes.The
config.roots.<rootName>.modelAttributesproperty should be used to define the attributes of a root, while
theconfig.roots.<rootName>.lazyLoadproperty should be used to define whether a root should be lazy loaded or not.Note that
config.roots.<rootName>.lazyLoadproperty is now deprecated and will be removed in the future. -
table: Table alignment is now output as CSS classes instead of inline styles by default. See #3225.
It can be reverted to the previous behaviour by setting the
useInlineStylesconfiguration option totrue. -
table: Changed the default value of
table.tableLayout.stripFigureFromContentTablefromtruetofalse. See #19771.As a result, the
<figure>wrapper is now preserved on content tables by default when the layout tables feature is enabled. -
CKEditor 5 DLL builds are no longer available due to the deprecation of legacy installation methods. See the migration path. See #17779.
-
CKEditor 5 packages no longer ship the
src/,theme/andlang/directories on npm due to the deprecation of legacy installation methods. See the migration path. See #17779. -
All styles previously shipped in
@ckeditor/ckeditor5-theme-larkhave been redistributed to the appropriate packages, which now provide those CSS assets directly.
-
core, editor-balloon, editor-classic, editor-decoupled, editor-inline, editor-multi-root: The editor no longer updates
config.initialDataduring startup. Useconfig.roots.main.initialDatafor single-root editors andconfig.roots.<rootName>.initialDatafor multi-root editors. See #19885. -
core, editor-balloon, editor-classic, editor-decoupled, editor-inline, editor-multi-root, watchdog: Added support for creating editors and watchdogs using configuration only, without passing a source element or initial data as the first argument. Passing a source element or initial data as the first argument is now deprecated but still supported. Use
config.attachToforClassicEditor,config.root.elementfor single-root editors, andconfig.roots.<rootName>.elementforMultiRootEditor. See #19887. -
ai: Moved the public API from
AIChattoAIChatController. This affects integrations that use theAIChatAPI. -
core: The default word breaking behavior in the content area has been updated to prevent unwanted breaks in tables. If you customized the
--ck-content-word-breakCSS variable in your integration, migrate to the new--ck-content-overflow-wrapvariable to retain the same effect. See #19986. -
engine: Deep schema verification during
model.insertContent()is now enabled by default. It is no longer behind an experimental flag. See #19217.Previously, this behavior required opting in via
config.experimentalFlags.modelInsertContentDeepSchemaVerification: true. Now it is always active, ensuring that all elements and attributes in inserted content follow the schema - including deeply nested structures.If needed, you can temporarily opt out by setting
config.experimentalFlags.modelInsertContentDeepSchemaVerification: false. Note that this option is deprecated and will be removed in a future release. -
export-pdf:
Export to PDFnow uses version2of the converter API by default. This may produce slightly different output, so update any converter options to match the new API. To keep version1, set theversionproperty in theexportPdfconfiguration object. -
import-word: The
ImportWordEditing#getToken()method is now asynchronous and returns a promise. -
mention: Mention elements in the data output now include the
data-mention-uidattribute. This affects only integrations that define custom mention downcast converters. If you defined one, update it to includedata-mention-uidin the output and omit it during clipboard operations; see the update guide. -
table: The improved handling of table heading rows is now enabled by default. Rows are no longer incorrectly marked or moved as header rows when earlier rows are not header rows. See #19431.
-
table: Added new block-level left and right alignment options. The editor also recognizes equivalent inline margin styles and converts them to these alignment types. See #3225.
-
table: The
shallowoption used withTableUtils#setHeadingRowsandTableUtils#setHeadingColumnshas been renamed toupdateCellType. See #19431. -
table: Added support for importing HTML tables with the legacy
border="0"attribute as borderless tables. Closes #19038. -
table: The experimental handling of the legacy
border="0"HTML attribute is now enabled by default. If you hadconfig.experimentalFlags.upcastTableBorderZeroAttributesin your configuration, remove it because the flag is no longer recognized. See #19038. -
track-changes: Moved
TrackChangesEditing#registerBlockAttribute()andTrackChangesEditing#registerInlineAttribute()to theSuggestionConversionplugin in theckeditor5-collaboration-corepackage.The purpose and behavior of these methods remains the same.
-
track-changes: Suggestion marker DOM elements now use the
data-suggestionattribute consistently.This may affect custom code or CSS that relies on
data-suggestion-id. -
ui: The scope of the
.ck-reset_all-excludedclass has been expanded to also include the container wearing that class (e.g. to limit inheritance of font properties).Because of this, elements of the CKEditor user interface excluded from the CSS reset by the usage of the
.ck-reset_all-excludedclass may be prone to unexpected styling. Please make sure to verify the visual styling of such UI elements after updating to this version. -
Updated to TypeScript
5.5.4.
-
ai:
AIChatControllerplugin now firesreplyCreatedandinteractionCreatedevents when a newAIReplyorAIChatInteractionis created. -
ai: Added the
ai.chat.context.alwaysAddSelectionconfiguration option. When enabled, the document selection is added to the AI Chat context automatically. This option is disabled by default. -
export-pdf:
Export to PDFnow uses version2of the converter API by default. To keep version1, set theversionproperty in theexportPdfconfiguration object. -
footnotes: Added support for configuring the items available in the footnotes list styles dropdown. Pass the
listStylesarray in the configuration to choose which list styles are shown. -
footnotes: Added support for the
arabic-indiclist style in footnotes. It is not shown in the dropdown by default, but it can be added to the list of available styles using thelistStylesconfiguration option. -
remove-format: The remove format feature now clears inherited formatting from empty paragraphs and other block elements. Closes #19851.
-
table: Introduced support for changing table cell types between
dataandheader. Closes #16730. -
table: Introduced support for the
scopeattribute in table header cells to improve semantic markup and screen reader accessibility. This feature is enabled by default and can be disabled by settingconfig.table.tableCellProperties.scopedHeaderstofalse. Closes #3175. -
table: Added support for table footers. You can now specify the number of footer rows in a table. The table row context menu has been updated with a new
Footer rowtoggle to control this setting. Closes #12952.This feature is disabled by default and can be enabled by setting
config.table.enableFooterstotrue.Thanks to @star-szr.
-
table: Preserved table borders from legacy HTML content. Closes #19633.
When loading HTML content that uses the deprecated
borderattribute on tables, the editor now keeps the original border width instead of ignoring it. -
table: Preserved table cell padding from legacy HTML content. Closes #19634.
When loading HTML content that uses the deprecated
cellpaddingattribute on tables, the editor now keeps the original cell padding instead of ignoring it.
-
ai: Fixed an issue where new lines were ignored in the user message displayed in the AI Chat feed.
-
ai: Reset the “Show changes” button state after the balloon for an AI Quick Action is displayed.
-
ai: Fixed the incorrect order of user messages and AI agent responses in the AI Chat feed when loading a conversation from history.
-
ai: Fixed an error thrown when the user stopped an ongoing AI Chat interaction and the remaining replies were not flushed to the UI.
-
ai: Fixed a console error that could occur when AI Quick Actions were closed during response streaming.
-
ai: Fixed an error thrown by CKEditor AI features when processing content that contains mentions. See #20010.
-
comments: Fixed inline annotations so they stay attached to the target element when it scrolls inside its parent container.
-
code-block: Fixed inconsistent vertical spacing around code blocks in the content area. Code blocks now use explicit vertical margins that match other block widgets. Closes #19982.
-
core: Fixed excessive word breaking in tables rendered in the content area. Words will now only break when they genuinely overflow their container, preventing awkward splits in narrow table columns. Closes #19986.
-
engine: Removed the unintended public exports
autoParagraphEmptyRoots,isParagraphable, andwrapInParagraph.These utilities were not part of the supported public API.
-
engine: Gradients in background styles are no longer ignored and are properly normalized. Closes #19787.
-
engine: Fixed background normalization so it no longer drops layers from the
backgroundCSS shorthand. Multi-layer backgrounds are now parsed and serialized correctly. See #19787. -
footnotes: Fixed the footnotes configuration typings to use
defaultListStyleinstead ofdefaultStyle. -
import-word: Improved the initialization time of the
ImportWordEditingplugin. Token retrieval now runs in the background, so it does not block editor startup. -
link: Removed the unintended public export
ensureSafeUrl.This utility was not part of the supported public API.
-
real-time-collaboration: Fixed the inconsistent font family in collaboration user markers.
-
show-blocks: Fixed the
Show blocksfeature so block labels render in all editor types when thedirattribute is present either on the editable element itself or on its ancestor wrapper. Closes #19866. -
track-changes: Fixed suggestion marker DOM elements that used
data-suggestion-idinstead ofdata-suggestion. -
ui: Updated the CSS reset rules so
.ck-reset_all-excludedalso applies to the container that uses this class. Closes #19967.This change reduces the impact of the CKEditor’s
.ck-reset_allclass in DOM elements that are explicitly excluded from the reset by the.ck-reset_all-excludedclass. -
ui: Disabling a menu bar menu now also closes it if it was open, preventing an open panel from remaining in a non-interactive state. Closes #18214.
-
core, editor-balloon, editor-classic, editor-decoupled, editor-inline, editor-multi-root, watchdog: Reorganized root-related editor configuration under
config.rootfor single-root editors andconfig.rootsfor multi-root editors. Closes #19885.The
config.initialData,config.placeholder, andconfig.labeloptions are deprecated in favor ofconfig.root.initialData,config.root.placeholder, andconfig.root.label.
In multi-root editors, define these options per root usingconfig.roots.<rootName>.initialData,config.roots.<rootName>.placeholder, andconfig.roots.<rootName>.label. -
paste-from-office, table: Introduced new table block alignments,
blockLeftandblockRight, allowing tables to be aligned to the left or right without text wrapping. The table properties balloon now includes two new buttons to easily apply these alignments. Closes #3225, #6174, #8412, #8752, #9982, #10867, #14921, #17932, #19337.Added additional spacing between a table and the surrounding text when wrapping is enabled. This prevents issues such as list markers overlapping with the table when placed next to each other.
Added support for pasting to and from MS Word for all table alignment types:
left,right,center,blockLeft, andblockRight. -
collaboration-core, track-changes: Moved
TrackChangesEditing#registerBlockAttribute()andTrackChangesEditing#registerInlineAttribute()to theSuggestionConversionplugin in theckeditor5-collaboration-corepackage. -
ai:
AIChatControlleris now a public class. Moved public API fromAIChattoAIChatControllerto avoid duplication. -
ai: Decreased the line height in the AI Chat prompt input field to match feed messages.
-
ai:
AIChat#addSelectionToChatContext()now returnsvoidinstead ofPromise. -
ai: Suggestion previews in AI features now follow the styling of the content in the editing area more closely.
-
ai: Optimized AI features initialization by caching model requests, reducing redundant network calls and improving load performance.
-
ai: Improved handling of agent responses in the Markdown format.
-
ai: Marked selected AI programmatic APIs as experimental. These APIs are production-ready but may change in minor releases without the standard deprecation policy.
-
ai: Added a shared CSS variable palette for colors used across the
ckeditor5-aipackage.This makes AI components easier to customize.
-
ai: Removed the built-in Amazon Bedrock integration in the legacy AI Assistant. The
AWSTextAdapterclass remains available but now throws an error when used, and this change does not affect CKEditor AI. If you rely on this integration, contact support. -
ckbox: Fixed an issue where the CKBox dialog was not visible in fullscreen mode. Closes #19290.
-
engine:
Model#hasContent()can now checkModelSelectionandModelDocumentSelectioninstances. See #19847. -
markdown-gfm: Enhanced
MarkdownGfmMdToHtmlto support custom plugins and to export the default plugin chain used by the Markdown parser. -
utils: Introduced
Rect.getDomElementRects()method that conveniently retrieves allRectsof a DOM element while preserving their source for further processing (e.g.Rect#getVisible()). -
Replaced string-based soft requirements with plugin constructors across selected packages to improve developer experience and align plugin dependency handling across repositories. This update also adjusts package metadata and dependencies to match the new constructor-based requirements. See #17779. Closes #19747.
The following dependencies no longer rely on soft requirements:
ckeditor5-ai:CloudServices.ckeditor5-ckbox:LinkEditing,PictureEditing,ImageUtils,ImageEditing,ImageUploadEditing,ImageUploadProgress,CloudServices.ckeditor5-ckfinder:Link,LinkEditing,CKFinderUploadAdapter.ckeditor5-easy-image:CloudServices,ImageUpload.ckeditor5-emoji:Mention.ckeditor5-export-pdf:CloudServices.ckeditor5-export-word:CloudServices.ckeditor5-heading:Paragraph.ckeditor5-import-word:CloudServices.ckeditor5-link:ImageEditing,ImageUtils,ImageBlockEditing.ckeditor5-list-multi-level:ListEditing.ckeditor5-merge-fields:ImageUtils,ImageEditing,Mention.ckeditor5-paste-from-office-enhanced:PasteFromOffice.ckeditor5-real-time-collaboration:Comments,CommentsRepository,CloudServices,RevisionHistory,TrackChanges,TrackChangesEditing.ckeditor5-revision-history:Users.ckeditor5-slash-command:Mention.ckeditor5-style:GeneralHtmlSupport.ckeditor5-track-changes:Comments,CommentsRepository,Annotations,EditorAnnotations.ckeditor5-typing:Delete,Input.ckeditor5-uploadcare:PictureEditing,ImageUploadEditing,ImageUploadProgress,ImageEditing,ImageUtils.
-
Updated
es-toolkittov1.45.1. -
Updated translations.