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.2.0.

The Media embed feature now supports resizing with drag handles and styling, including alignment with optional text wrapping. Embedded videos and other media can be aligned left, right, or centered, with surrounding content flowing around them.

Editor roots can now be attached to or created as block-level elements other than the default container, including headings, paragraphs, and custom block elements with their own classes, styles, and attributes. This helps integrate CKEditor 5 with CMSes and other systems that edit individual content fields rather than a single wrapper.

The list feature now supports skip-level lists. List items can be nested at non-sequential indentation levels, for example a third-level item placed directly under a first-level one, preserving the structure of documents imported or pasted from Word and HTML sources.

CKEditor AI now works in editors configured with General HTML Support. AI Chat, AI Quick Actions, and AI Review can apply and suggest changes on content that uses additional elements and attributes.

The AI Chat input now supports pasting and drag and drop. Screenshots from the clipboard and other images are added as context attachments, URLs are detected and displayed as link pills, and long pasted text is attached as a text file.

• Multi-root and multi-editor support. AI Chat and AI Review now support multi-root and multi-editor integrations, including adding or removing editor instances at runtime.
• Default typography improvements for AI Chat responses. AI Chat now includes built-in styles for common content types, improving the readability of generated output.
• Resilient streaming. Streaming replies in AI Chat are no longer cancelled when the page is closed or reloaded. The reply keeps streaming on the server and reconnects when the conversation is reopened.

• ai: Changed CKEditor AI APIs used by custom workflows. Review the following changes and see the API documentation for details.

  • Removed methods:

    • AIChatContext#updateCurrentDocument() (use AIChatContext#updateCurrentDocuments() instead).
    • AIEditing#sessionId (use AIEditing#getSessionId( editor ) instead).
    • AIChatContext#getSourceByDataId()
    • AIChatContext#getDocumentContextSliceByDataId()

  • Removed properties:

    • AIReply#documentId
    • AIReply#newNodeAnchorIds
    • AIReply#dataIdDocumentSources

  • Modified method signature:

    • AIReply#appendContent( content )
    • AIEditing#modelToDataWithIds( modelFragment )
    • AIChatController#addSelectionToChatContext()
    • AIEditing#getSelectionText()

  • Modified property type:

    • AIReply#content
    • AIReply#parsedContent
    • AIReply#parsedMergedContent
    • AIReply#documentContextContent

• core, editor-balloon, editor-classic, editor-decoupled, editor-inline, editor-multi-root, ui: Added support for describing editable root elements through config.root.element and config.roots.<rootName>.element without supplying an existing DOM node. The configuration now accepts a tag-name string, such as 'h1', or a ViewRootElementDefinition object that defines the tag name, CSS classes, inline styles, and attributes. The <textarea> and <input> elements are not supported because they cannot host rich-text editables. Closes #20047.

• collaboration-core, track-changes: Track Changes now integrates with the General HTML Support feature. GHS-produced elements and attributes are now tracked as suggestions instead of being applied silently to the document content.

  Changing GHS-produced HTML attributes, classes, or inline styles creates attribute suggestions. Suggestion descriptions now list inline styles by name and value, such as Set format: border-color (green), and group class or HTML-attribute changes under concise labels, such as Set format: style, metadata. Insertion and deletion suggestions for GHS-driven elements, such as <section>, <iframe>, and <article>, now use HTML element names.

• collaboration-core, track-changes: Track Changes now records suggestions for media embed resize and style changes.

• autoformat, list: Numbered list autoformat now accepts any starting number. Typing any number followed by . or ) and a space (e.g. 5. ) creates a numbered list. When the list.properties.startIndex option is enabled, the list starts at the typed number.

• ai: Introduced General HTML Support integration with CKEditor 5 AI. AI Chat, AI Quick Actions, and AI Review can now process content that uses additional HTML elements and attributes.

• ai: Introduced a programmatic API for the AIReview plugin. See details in the Using CKEditor AI programmatically documentation.

• ai: Introduced paste support in the AI Chat input.

  Pasting a single bare URL adds it to the conversation context as a link pill. Pasting plain text above a configurable threshold attaches it as a .txt file. Pasting an image or any supported file attaches it to the conversation context as a file pill, with image pills using a dedicated icon.

• ai: Introduced drag-and-drop support to the AI Chat input.

  Files dropped onto the prompt input area are added to the chat context as pills. URLs and text dropped from the browser are also added to the conversation context as corresponding pills. The AI Chat input panel now shows a visual hint during the drag.

• editor-multi-root: The MultiRootEditor#createEditable() method now accepts an existing HTMLElement or a ViewRootElementDefinition, so dynamically added roots can be attached to caller-owned DOM elements. Element definitions supplied at root configuration time are also replicated through real-time collaboration. Closes #20047.

• email: Tables with resized columns now keep their column widths when exported as email. Previously, they fell back to auto-distributed sizing in Outlook and other email clients.

• list: Added support for skip-level lists. List items can now be indented by more than one level at a time by enabling the list.enableSkipLevelLists configuration option. Closes #12563.

• media-embed: Introduced the media embed resize feature that allows users to resize embedded media via drag handles. Closes #6593.

  Embedded media now uses the aspect-ratio CSS property instead of a padding-bottom wrapper.

• media-embed: Introduced the media embed alignment feature, with optional text wrapping. Closes #2781.

• media-embed: Added config.mediaEmbed.styles.options for picking a subset of the built-in media embed styles, overriding their fields, or registering custom ones. The config.mediaEmbed.toolbar now also accepts inline split-button dropdown definitions. Closes #20131.

• clipboard, paste-from-office: Fixed ClipboardPipeline and PasteFromOffice to allow common HTML string normalization before conversion to the view. Closes #17309.

• ai: Fixed an issue where AI Chat temporarily displayed wrap and unwrap proposed changes as removals before converting them to formatting changes.

• ai: The editor no longer crashes when users interact with double-unwrap proposed changes, such as changes in nested block quotes or custom widgets.

• ai: AI Chat Shortcuts buttons are now disabled while a context item is being uploaded, preventing the shortcut from executing until the context is ready.

• ai: Fixed the model-nodelist-offset-out-of-bounds error thrown by AI Quick Actions when the selection started at the end of the previous block, for example when selecting a full paragraph that begins after the trailing boundary of the block above it.

• ai: The preview balloon now scrolls back to the top when switching between AI Chat suggestions.

• ai: AI plugins no longer block editor initialization with HTTP requests. Model fetching, conversation creation, and review checks loading now run in the background while the editor becomes interactive immediately.

• ai: Fixed a visible scrollbar appearing in AI suggestion boxes caused by suggestion marker borders being clipped by the container overflow.

• ai: Improved AI Chat stability in multi-editor setups.

  AI Chat no longer crashes when users interact with suggestions or replies from destroyed editors or removed roots. The “Current document” chat context option now reflects the presence of editor instances, and Track Changes suggestion actions now behave consistently across multiple editors.

• ai: Fixed an issue where the HTML Embed widget could be duplicated after content was processed by AI features.

• ai: The AI Review “review completed” header title now truncates with an ellipsis when it overflows the available space in the check results view, matching the behavior of the empty-results completed view.

• ai: Preserved whitespace and newlines inside preformatted blocks in AI Chat replies.

• document-outline: Fixed headingId attribute handling for custom heading elements configured with non-standard model names, such as heading2, or object-based view definitions, such as view: { name: 'h2', classes: 'fancy' }. Previously, such configurations could result in errors during editor.data.parse(...) processing.

• footnotes: Fixed incorrect spacing of the footnotes list divider.

• heading: The Title feature now handles editor configurations where some or all roots use a custom modelElement. Roots that do not accept the title element are skipped at runtime, and the feature logs a single warning when no root supports the title structure. Closes #20026.

• html-support: The General HTML Support schema for the hgroup element now works in editor configurations using a custom root modelElement. Closes #20026.

• html-support: The HTML comments feature no longer assumes the root model element is $root. Comments are now preserved in editor configurations using a custom root modelElement. Closes #20026.

• link: The link preview button now displays the no URL label for links with an empty href. Closes #20136.

• link: Fixed an issue where the link edit form back button was hidden when editing a link with an empty URL via the balloon toolbar. See #20136.

• link: Fixed text centering in the link preview button. See #20136.

• media-embed: Spotify track embeds now use a fixed height instead of a fluid aspect ratio to prevent incorrect resizing.

  Spotify track embeds now render at a fixed 80px height, matching the compact single-row player. Album and artist embeds are unaffected and continue to use a responsive aspect ratio.

• pagination: The pagination page navigator no longer changes its width based on the document’s page count, so the toolbar’s “show more items” button stays visible when long documents are loaded.

• paste-from-office: Fixed an issue where list items pasted from Word with three or more nesting levels could appear too far to the right when ancestor items had explicit paragraph indentation. Their position now matches Word’s visual layout regardless of nesting depth.

• paste-from-office: Lists pasted from Microsoft Word now keep consistent left indentation. Closes #20179.

  Top-level list items that shared the same indentation in the original document no longer become visually misaligned in the editor when the list is interrupted by another list or by an empty paragraph. Nested list items pasted directly after their parent now keep their nesting level.

• ai: AI Chat messages now use larger body text, a clearer heading hierarchy, more spacing between list items, and distinct styling for code, tables, block quotations, and horizontal rules.
• ai: Streaming replies in AI Chat are no longer cancelled when the page is closed or reloaded. The reply keeps streaming on the server, and returning to the conversation reconnects to it and displays the remaining content. The reply is cancelled only when the Stop generating button is used.
• image: Inline images are no longer allowed in roots or other limit elements that do not accept block content, such as $inlineRoot and custom inline-only roots. This also applies to custom limit element types contributed by integrators. Closes #20047.
• ui: The HighlightedTextView component now processes text containing HTML-special characters, such as &, <, and >.

We are happy to announce the release of CKEditor 5 v48.1.1.

The release addresses vulnerabilities identified in the protobuf.js package, used within our @ckeditor/ckeditor5-operations-compressor package for real-time collaboration.

Our analysis confirms that vulnerabilities do not affect CKEditor 5.

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.

• ai: Fixed an issue where the AI Review tooltip was not appearing when hovering over review suggestions.
• footnotes: Fix incorrect spacing of footnotes list divider.

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 use td[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.modelElement for single-root editors and config.roots.<name>.modelElement for multi-root editors, allowing integrators to configure the model root element type. Added the $inlineRoot generic schema item for use with the new editor configuration. Closes #20029.
• core, editor-balloon, editor-classic, editor-decoupled, editor-inline: Enabled the modelAttributes root configuration option for all single-root editors.
• ai: Added the opt-in config.ai.container.collapsible configuration option. When enabled, clicking the active tab button toggles the .ck-ai-tabs_collapsed CSS class on the .ck-ai-tabs element. The option defaults to false.
• ai: The AIChatController#startConversation() method now accepts an optional modelId parameter to select a specific model for the new conversation. Custom Quick Actions of type chat with a model property 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.headings option 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 align attribute 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 runAfterDocumentTransformation and runAfterChildrenTransformation callbacks. 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 with copyOnEnter are 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 action without a model property now fall back to the default model from the ai.models.defaultModelId configuration or the first available model. Previously, they failed with a 400 backend 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-attached error 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.stripFigureFromContentTable option is set to false and the PlainTableOutput plugin is not included. Tables now keep their alignment, dimensions, and styling.

• email: Fixed figcaption width and overflow issues in exported table figures. When exporting a table wrapped in a figure, its figcaption no longer receives an incorrect width and stays within the bounds of the exported element. Captions with caption-side: top are 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 after saveRevision() 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#description configuration 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 to ModelDocument#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.