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 v47.3.0.

This release introduces a minor stability update, featuring focused fixes and improvements, as well as experimental features.

Finding a specific AI Quick Action in a long list with multiple groups can be difficult. To improve this, we are adding a filter input that lets users search for quick actions directly within the dropdown.

Visibility of the input can be easily configured using the config.ai.quickActions.isSearchEnabled configuration option.

This release also brings several minor but significant enhancements and fixes:

• Track Changes markers not related to AI suggestions are now displayed in gray in the AI balloon text preview, consistent with the behavior of AI chat.
• When retrying a specific AI Review, we are now ensuring the latest version of the document is used.
• We also improved error handling across CKEditor AI, making it easier to debug backend-related issues by including more detailed error messages.

We keep our LTS version promise: no breaking changes until the Active LTS moves to Maintenance LTS phase (April 2026). It also means that introducing larger features can be challenging if someone is waiting for specific improvements.

To address this, we are introducing experimental flags and experimental plugins. These options allow you to preview and test upcoming changes.

• New table alignment options

  Enable config.experimentalFlags.useExtendedTableBlockAlignment and load the experimental UI plugins TablePropertiesUIExperimental and TableCellPropertiesUIExperimental for upcoming improvements to table block alignment. New options allow setting left and right table block alignment without text wrapping and resolve issues such as #3225. We also improved table properties and cell properties balloon interfaces. This change will be the default in version 48.0.0.

• Improved table border normalization

  Setting config.experimentalFlags.upcastTableBorderZeroAttributes enables support for the normalization of HTML tables that use border="0". This change will be the default in version 48.0.0.

• Better deep schema validation

  After enabling the config.experimentalFlags.modelInsertContentDeepSchemaVerification flag, the editor performs deep schema verification during model.insertContent() operations. This ensures that the inserted content fully follows the editor’s schema, even in complex or nested structures. This change will be the default in version 48.0.0.

Read more about these experimental features in the documentation.

• ai: The AI balloon contents is always scrolled to the bottom, so the most recent content is always visible to the user.
• ai: AI Quick Actions are now searchable in the dropdown. Search input can be hidden using the config.ai.quickActions.isSearchEnabled configuration option.
• restricted-editing: Introducing an automatic command (restrictedEditingExceptionAuto) and dedicated toolbar button (restrictedEditingException:auto) for creating restricted editing exceptions (both block and inline). Closes #19353.

• ai: AI Review now uses the latest editor content when the review check was retried (via “Try again” button).

  This improvement fixes the issue when cached content was send on retry and any new changes, applied review suggestions or changes made by other users in real-time collaboration, were not sent and accounted by AI when generating new results.

• ai: AI Review no longer results in an error when the AI service returns an unexpected response (multiple elements when one is expected).

• ai: Track Changes markers not related to AI suggestions are now displayed in gray in AI balloon text preview, consistent with AI chat behavior.

• ai: The translate check in AI Review now correctly translates the image alt attribute text.

• ai: The caption of images (<figcaption> element) is now correctly processed by AI Review checks instead of being ignored.

• ai: Errors caused by AI feature during initialization no longer crash the editor.

• ai: The AI feature keeps the correct UI state after a runtime error occurs.

• ai: The AI Review “Custom command” is hidden if the model list cannot be obtained.

• ai: Error messages in AI Chat History are now displayed correctly. Previously, errors caused the history view to appear empty instead of showing the error message.

• ai: AI suggestions balloon content no longer stick out of the balloon on very small screens.

• ckbox: Fixed CKBox Image Editor not respecting the language configuration option. Closes #19338.

• comments: Fixed an issue where the comment toolbar button remained enabled even when the command to create a new comment thread was disabled (e.g., in read-only mode).

• comments: Disabled revision history toolbar and menu bar buttons in comments-only mode to prevent users from using revision history features.

• footnotes: Fixed an issue where cutting and pasting an empty footnotes list in the middle of a paragraph would incorrectly split the paragraph.

• footnotes: Fixed an issue where the content of pasted footnotes was lost when the multiBlock configuration option was disabled.

• footnotes: Fixed incorrect start number shown in footnotes UI when loading a document with existing footnotes.

• footnotes: Footnote lists styled with alpha-lower and alpha-upper are now correctly highlighted in the footnotes UI.

• line-height: When line height is applied to a to-do list item, the checkbox is now vertically centered correctly.

• pagination: Improved calculation of page breaks when long tables are present in the content.

• revision-history: Fixed an issue where revision history buttons remained incorrectly enabled in read-only mode in the menubar.

• table: Fixed an issue where tables with merged cells ([rowspan]) in header columns were not handled correctly. Closes #14826.

  Thanks to @bendemboski.

• ai: Review suggestions can now be previewed by hovering over changes in the content, significantly enhancing the review process.

• ai: Stopping generation in AI chat now clears the selection from the pending context.

• ai: Custom AI quick actions referencing unavailable models are now disabled.

  They are displayed as grayed out, and an error is logged to the console during the editor initialization to help integrators detect and fix the issue before it impacts end-users.

• ai: Removed misleading console warnings that appeared during AI response streaming.

• ai: Error messages concerning the AI feature logged in the browser console now contain the details provided by the backend service.

• engine: Introduced the experimentalFlags configuration option that allows enabling or disabling specific experimental behaviors in CKEditor 5. Closes #19217.

  Added a new experimental flag: modelInsertContentDeepSchemaVerification. When enabled, the editor performs a deep schema verification
  during model.insertContent() operations, ensuring that inserted content fully complies with the editor’s schema even in complex
  or nested contexts.

• list: Added support for passing consume parameter to ListEditing#registerDowncastStrategy method which allows to control whether the downcasted element should be consumed or not. It also disables consume checks for the downcasted element to allow defining side effects without consuming the model attribute.

• table: Added experimental support for importing HTML tables with the [border="0"] attribute. Tables with this attribute are now automatically converted to borderless tables in the editor by applying border-style: none to both table and table cell elements. Closes #19038.

  This change needs to be enabled by setting experimentalFlags.upcastTableBorderZeroAttributes to true. In the next major release, this flag will be removed and the upcast will be performed by default.

• The development environment for CKEditor 5 now requires Node v24.11.

We are introducing CKEditor AI, a powerful writing assistant that brings AI-powered content creation directly into CKEditor 5. It helps users create, review, and refine content without switching between tools, making the editing experience faster and more productive.

CKEditor AI includes three core capabilities:

• AI Chat: a conversational AI assistant for multi-turn interactions that supports context setting and model selection. All conversations are tracked in a persistent chat history, and suggestions are reviewable before being applied.
• AI Quick Actions: one-click transformations for selected text, including rewriting, simplifying, expanding, summarizing, or adjusting tone. Changes appear inline with preview capabilities.
• AI Review: automatic quality assurance that checks grammar, tone, clarity, and style across the document. Suggested changes are presented in a visual review interface where users can accept or reject individual edits or apply all approved suggestions in bulk.

Power users can select their preferred model during sessions (GPT-5, Claude 3.5, Gemini 2.5, and more), while integrators maintain control over access rules and usage tiers.

Built as a plugin for CKEditor 5, it integrates quickly into existing applications with minimal configuration, and all AI interactions are fully observable via audit logs and optional APIs.

CKEditor AI is available as a premium add-on to all paid CKEditor 5 plans with a transparent subscription-plus-usage pricing model. A 14-day trial is available with access to all premium features.

A brand-new Footnotes feature is here! It lets users insert and manage footnotes directly in their content, keeping references organized and readable. Footnotes stay linked to their source text and update automatically when edited, ideal for academic, legal, or technical writing. You can also customize the numbering, including the starting number and numbering style, to match your document’s formatting needs.

Restricted editing now supports block-level restrictions, not just inline ones. This makes it easier to protect the entire content while still allowing controlled edits where required. A common use case is unlocking for editing template sections like paragraphs, tables, or structured document parts, and protecting the rest of the content.

We are extending the sunset period for old installation methods (#17779) to the end of Q1 2026. It is a good moment to consider switching to the LTS edition for long-term stability and an additional 3 years of support for the old installation methods.

This release also brings several smaller but important enhancements and fixes:

• View engine stability: Fixed a bug where placeholders could remain visible after view changes, such as moving or replacing elements.
• Downcast reliability: The elementToStructure helper now handles nested structures and list elements more consistently, ensuring correct reconversion and structure maintenance.

• ai: Added a new configuration option, config.ai.chat.context.searchInputVisibleFrom, to manage the visibility of the search input in the AI Chat context panel.
• footnotes: Added a new package @ckeditor/ckeditor5-footnotes that provides the footnotes feature. This feature allows users to add and manage footnotes in their documents, enhancing the document’s readability and providing additional context where necessary.
• fullscreen: Enabled CKEditor AI support in Fullscreen mode, allowing users to access AI tools while editing in fullscreen. Closes #19234.
• fullscreen: Sidebars in the fullscreen mode will now automatically collapsed and expanded depending on the available space in the viewport. Closes #19294.
• restricted-editing: Introduced block editable areas in restricted editing. Closes #9071, #5953.

• ai: If the content you were working on in AI Balloon gets removed (for example, by another user), a proper message will appear with the information and prevent further actions that could lead to errors.

• ai: Conversations loaded from AI Chat History are now correctly scrolled to the last message.

• ai: Fixed visual inconsistencies of hover state in AI Chat.

• ai: Fixed visual inconsistencies in AI Chat context section.

• ai: Fixed AI Chat resize button hover and active visual states.

• ai: Fixed various visual issues across the AI feature.

• ai: Fixed an issue where using DLLs for the AI package together with the TrackChanges plugin could fail due to a DocumentCompare plugin conflict.

• ai: Removed doubled border at the bottom of review mode suggestions list.

• ai: The styles in the AI feature operate independently from one another.

• ai: Prevent editor crash on exiting pending AI review check.

• ai: Configuration option ai.availableReplyActions will now also impact visibility of buttons displayed next to “Change X” header, which are displayed in AI Chat feed when AI returns multiple changes.

• ai: Fixed handling inline objects (such as inline images) by AI Review. Inline objects were incorrectly presented in the AI Review sidebar, and often were removed from the editor content upon accepting a change next to it.

• ai: When a user applied and then undone an AI-proposed change, which has affected existing markers, these markers were incorrectly removed instead of being restored.

• ai: Improved AI Review content processing mechanism preventing some errors originating from unexpected LLM responses.

• ai: Improved the positioning of the model selection dropdown in the AI Chat feature to ensure it remains visible when space is limited.

• ai: Navigation across changes proposed in AI Chat should not break if unsupported changes (which cannot be displayed) were returned by the agent.

• ai: Fixed crash happening when an AI-proposed change, that included an existing suggestion, was itself inserted as a suggestion.

• ai: The CKEditor AI balloon displaying content changes should remain within the viewport boundaries when used with long content selections in the editor.

• ai: The AI balloon with suggested content changes should always position itself next to the relevant piece of content in the editor during navigation across multiple changes.

• clipboard: The drop marker is now shown only when the target range is editable. Dropping content into non-editable is now prevented. Closes #19028.

• engine: The elementToStructure downcast helper created elements should work more reliably in various edge cases: Closes #16055, #15919, #11739, #19209.

  • It should properly detect required reconversion on all nesting levels.
  • It should use proper position inside slot to maintain proper view structure.
  • It should refresh child elements when they got renamed, for example paragraph to heading.
  • It should work correctly with lists inside.
  • It should create proper structure with list inside.

• engine: The model.insertContent() and model.insertObject() should verify the whole Schema context before checking auto-paragraphing. Closes #19210.

• engine: Fixed a bug where placeholders could become stuck and remain visible on elements when the view changed. Closes #14354, #18149.

  This resolves two scenarios:

  • Dropping an image into the editor before an element with a placeholder (the placeholder could remain on the original element).
  • Moving the element that hosts the placeholder to a different place in the view tree (the placeholder could stay attached to the old node).

• icons: Removed obsolete clip-path attributes from various SVG icons (IconAIHistory, IconShowChangesOff, IconShowChangesOn, IconUploadcareImageUpload) that cause rendering issues in some corner cases. Closes #19291.

• pagination: Fixed an issue where the pagination feature incorrectly displayed redundant page break indicators in editing mode when a page break was inserted between two tables.

• paste-from-office: No longer treat elements with mso-list:none as list items.

• restricted-editing: Empty editable regions created with Restricted Editing should not get dropped when reloading the editor’s data. Closes #16376.

• restricted-editing: Backspace should remove content in restricted editing mode when the entire section is selected. Closes #18892.

• table: The editor should not crash when trying to load data with a table inside an image caption. Closes #19211.

• table: The TableConfig type is no longer exported as internal.

• widget: Fixed changing (expanding and shrinking) the selection with the keyboard while widgets are involved. Closes #19212.

• ai, track-changes: CKEditor AI no longer requires the Track Changes feature, and can be used without it. In such setup, CKEditor AI will not be able to insert AI-proposed changes as suggestions and all related buttons will be hidden.

• ai: Renamed the automatically selected AI model to “Auto” (previously “Agent”). Allowed for using 'auto' in config.ai.chat.models.defaultModelId and config.ai.chat.models.displayedModels configurations to make integration easier.

• ai: Improved real-time collaboration support in AI Review. Changes adjacent or within review suggestions in the editor content, made by remote users, will correctly invalidate/restore review suggestions.

• ai: Added missing AISuggestionActionName export, which is used in the CKEditor AI feature configuration.

• ai: AI Review suggestions now remain visible after being accepted or rejected, also can be marked as outdated if they are affected by RTC changes.

• clipboard: Loosened rules for drop target position lookup so it is possible to drop in-text when there is anything droppable into in-text context.

• icons: Added IconDocumentOutlineToggle icon.

• icons: Introducing an icon that represents an outdated state. Closes #19282.

• paste-from-office: Added normalization of footnotes while pasting content from Word.

• table: Fixed incorrect Japanese translations for table layout feature. Closes #19255.

  Thanks to @ponyoxa.

• uploadcare: Added a configuration option config.uploadcare.locale that allows providing custom translations for Uploadcare components or using predefined CDN URLs for other languages, enabling full localization beyond the default English version.

• utils: Exposed a utility function getConstrainedViewportRect(), which returns the bounds of the visible viewport. Closes #19222.

• widget: The Esc key handling in widgets is registered in the editable element context. This allows easier customization of handlers for Esc keypress inside widgets and nested editable elements.

• Updated translations.

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

This release introduces a minor stability update, featuring focused fixes and UX improvements.

• ai: Simplified CSS for the CKEditor AI integration in a sidebar mode (config.ai.container.type: 'sidebar') by removing default layout constraints:

  • Removed the default min-height from .ck-ai-chat,
  • Removed the default height from .ck-tabs,
  • Removed the default width from .ck-ai-tabs.

  Also, the --ck-tabs-panels-container-width custom property has been removed from the codebase.

• ai: Added the config.ai.container.visibleByDefault configuration option to allow for hiding the AI component on the editor initialization.

• ai: Fixed TypeScript errors when using the AIChat plugin caused by incompatible constructor() signatures.
• ai: The editor no longer throws an error when accepting or rejecting proposed changes in review mode for “Adjust length” and “Adjust tone and style” checks.
• ai: Fixed an issue where balloons were displayed under the AI container in the overlay mode.
• ai: “Chat commands” from AI Quick Actions could not be correctly used if the selection was collapsed (nothing was selected). Now, a collapsed selection is correctly expanded to the entire element, which includes the selection.
• ai: AI Quick Action buttons added to the editor toolbar and to the balloon toolbar will no longer gain focus on hover, which had led to incorrect UI behavior.
• link: Changing the link’s “displayed text” using the link contextual balloon resulted in incorrect changes if track changes were turned on. Closes #19193.
• pagination: Images placed in tables should not affect the pagination calculations.
• revision-history: Revision history was showing incorrect revision data in a scenario where, for the same current revision, a user made a deletion before another user’s deletion, in the same element.

• ai: Improved performance of the AI Chat prompt input field, which was lagging while typing if the AI Chat feed contained a very long conversation.
• ai: Made the config.ai.chat.models configuration property optional because a default configuration is always provided by the plugin anyway.
• ai: Enabled keyboard navigation within the custom command form in AI Review.
• ai: Added validation to the AI Review custom command form to disallow sending an empty prompt.
• ai: Changes proposed by AI, which cannot be applied anymore due to other changes that happened in the document, will now be marked as outdated instead of throwing an error when interacted with.
• ai: Improved the title for AI Review parameterized and custom checks, so it is clear what parameters were used to run the review.
• ai: AI Chat will now display a message if the requested model is no longer available. This may happen, for example, when a conversation is loaded from the history.
• ai: AIQuickActions now adds AIActions plugin as its dependency. This is to ensure that the AI Quick Actions dropdown is populated by the default set of actions, without the need to add AIActions plugin manually.