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

CKEditor 5 v47.5.0 is a minor update that improves AI-assisted editing workflows and provides access to the new version of the Export to PDF feature.

The AI Translate feature of CKEditor AI allows users to translate entire documents on the go. It provides a user interface similar to AI Review, but with translation-specific actions to streamline the process. The translation view displays the final translated document, with original snippets shown on the side for review and comparison.

We improved how multiple changes proposed by the AI Chat feature are presented. Suggested changes now appear as cards that can be previewed in the content and applied consistently in both single-change and multi-change scenarios. This release also includes several under-the-hood improvements.

The export to PDF feature now supports version 2 of the HTML to PDF converter API, bringing several powerful enhancements to document generation.

Advanced header and footer configurations allow for different content on first, odd, and even pages, with support for images. Page sizes can now be set using predefined formats or custom width and height values. The new converter API also enables editing of PDF metadata fields such as title, subject, and author.

Security capabilities have been expanded with owner password protection for controlling permissions and digital signature support using PKCS#12 certificates for authenticity verification. Additional improvements include compression control for specific use cases, more precise rendering options, and experimental automatic outline generation for creating a table of contents.

Please note that the old installation methods will no longer be available with CKEditor 5 v48.0.0, which is planned for release at the beginning of Q2 2026. For more timeline details, refer to the dedicated GitHub issue.

In CKEditor 5 v42.0.0 in June 2024, we introduced new installation methods designed to improve and simplify the developer workflow. Soon, they will be the only available paths to install and use CKEditor 5.

If your project still relies on old installation methods, now is a good time to plan your next steps. We recommend choosing between these two options:

1. Migrate to the new installation methods, which are the recommended path for most users. The new installation methods provide a cleaner setup, easier upgrades, and better alignment with future CKEditor 5 releases.
2. Consider CKEditor 5 Long Term Support (LTS). If migrating in the near term is not feasible, you can extend support for legacy installation methods.

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

• ai: The ai.reviewMode.translations configuration option has been moved to ai.translate.languages. The ai.reviewMode configuration namespace has been removed.

  Together with the introduction of AI Translate feature and a separate translation tab, the configuration option to define a custom language list
  has been moved to a related ai.translate namespace.

• ai: The AIEditorIntegration plugin is now required to preview the changes suggested by the AI Chat feature in a dialog window. Previously, this functionality was enabled by just loading the main AIChat plugin. Please make sure your integration loads the AIEditorIntegration plugin in order to use this functionality.

• ai: The DOM structure of the AI Chat suggestions in conversation has been changed, which may affect integrations that customized the UI and/or rely on specific CSS selectors.

  Please make sure to update your integrations to use the new DOM structure. Learn more about the changes in the migration guide provided in the project documentation.

• ai: The DOM structure of the AI Chat suggestion preview dialog window has been changed which may affect integrations that customized the UI and/or rely on specific CSS selectors.

  Please make sure to update your integrations to use the new DOM structure. Learn more about the changes in the migration guide provided in the project documentation.

• ai: AIChat#sendMessage() takes attributes: Record<string, unknown> as one of its parameters now, in place of former quickActionData. This affects you only if you provided some customizations for the CKEditor AI chat feature.

• ai: Already existing chat conversations, which were created through AI Quick Action (e.g. “Explain” or “Summarize”), when loaded from chat history, will now display a full prompt instead of the short version. This affects only already created conversations.

• ai: Replaced ai.chat.models.modelSelectorAlwaysVisible configuration option with ai.chat.models.showModelSelector. The behavior has also been slightly updated. When set to true (default), the model selector dropdown is shown (when multiple models are available), or the model name is displayed (when only one model is available). When set to false, the selector is hidden, regardless of the number of available models.

• ai: The model’s configuration options have been moved from config.ai.chat.models to config.ai.models to ensure consistent model configuration across all AI features. The model configuration is now applied uniformly in both AI Chat and AI Review Mode.

• ai: Introduced the AI Translation tab.

  A new tab dedicated to translating content has been introduced to CKEditor 5 AI. It focuses on working with translated content, streamlining
  the process of applying translation and making the whole process easier and faster for end users.

• ai: Introduced a new look and improved operation of the AI Chat sidebar.

  • The list of changes proposed by the AI now features a sleeker design and includes a button to apply individual changes.
  • You can now preview suggested changes in a dialog window by clicking on a change in the sidebar.
  • The AI suggestion preview dialog window has been made more compact for enhanced usability.
  • Various bug fixes and other improvements.

• ai: Introduced AIChat#registerToolDataCallback(). It allows for handling custom data generated by your AI tools connected to CKEditor AI backend.

• ai: Introduced an API to allow inserting arbitrary HTML into the AI Chat feed, during AI response streaming.

  The API is passed as one of the parameters to the callback registered using AIChat#registerToolDataCallback().

• ai: Introduced configuration option ai.chat.initialConversation that manages whether a new, or an existing past conversation is initially loaded in the AI Chat.

• ai: Added a new configuration option, ai.chat.context.customItems, that allows using external context providers and custom context items (for example, IDs instead of actual files).

• export-pdf: Add support for version 2 of the HTML to PDF converter API.

• image, paste-from-office: Images aligned left or right with wrapped text around them should now be correctly pasted and imported from Word into the editor. Previously, such images were incorrectly aligned using block left or block right styles. Closes #19636.

• ai: The AI Review active suggestion highlight in the editor content no longer disappears due to content changes made by other users in RTC.

• ai: The AI Review suggestions content in the sidebar is styled the same way as the editor content, giving it a uniform look.

• ai: Fixed an issue where web search sources were not displayed correctly when loading conversations from chat history.

• ai: The “Add context” button in AI chat will no longer be disabled if the only available context are external resources.

• ai: Fixed an error when custom AI Quick Actions used a model that was not available in AI Chat.

• ai: Accepting suggestions from conversations loaded via chat history no longer throws errors in the console.

• ai: Fixed an issue where messages loaded from chat history could be incorrectly duplicated in a conversation.

• ai: AIQuickActionsUI now requires AIConnector to prevent authentication bugs when run standalone.

• comments: Fixed an issue where inline annotations were not displayed correctly when the editor was initialized in a hidden container.

• email: Table block alignment now behaves as expected in Microsoft Outlook, preventing text from wrapping around the table when it shouldn’t.

• html-support: An inline content (<img>) should not be stripped out of <div> inside of <dd> tag. Closes #19709.

• table: Resizing the last column of a layout table no longer increases the column size more than expected. Closes #19644.

• table: Fixed parsing units of deprecated table width attribute. Closes #19665.

• ui: BalloonToolbar will no longer reposition itself when invisible in the ContextualBalloon stack. Closes #19696.

  This prevents interfering with other features that might be using the ContextualBalloon stack.

• utils: Rect#getDomRangeRects() now sets the DOM Range as a source for each returned Rect, improving visibility and positioning of floating UIs that depend on Rect#getVisible(). Closes #19705.

• utils: Rect#getVisible() should better discover relationships between positioned and clipping parents. Closes #19707.

  This avoids issues with floating UIs that depend on Rect#isVisible() and do not hide when they should.

• basic-styles, engine, font, highlight, language: Fixed a discrepancy where applying a text attribute (such as bold) to a selection that included empty paragraphs did not set stored selection attributes on those paragraphs. See #19664. Closes #18430.

• ai: Suggestions shown in AI Review sidebar now include all formatting (bold, italics, etc.) and non-plain text elements (for example, links).

• ai: AIChat#sendMessage() now allows passing attributes (arbitrary custom metadata) together with the submitted user message. You can also pass attributes.displayedPrompt to display a different prompt instead of the one used to query the AI model (userMessage).

• ai: If there is only one source of AI chat context available, it will be automatically selected when the “Add context” button is pressed instead of showing a dropdown with only one option.

• ai: As more models are supported by the AI feature, only a set of recommended models will be displayed in the AI chat models dropdown. You can configure the list of displayed models via ai.chat.models.displayedModels in the config.

• ai: Conversations loaded from chat history are no longer blocked for models that are not recommended or not displayed, as long as the provider supports the model.

• ai: Replaced ai.chat.models.modelSelectorAlwaysVisible configuration option with ai.chat.models.showModelSelector. When set to true (default), the model selector dropdown is shown (when multiple models are available), or the model name is displayed (when only one model is available). When set to false, the selector is hidden, regardless of the number of available models.

• ai: Added a clear explanation in AI Chat for conversations loaded from history, explaining why AI proposals (document modifications) for past conversations cannot be applied or added as suggestions.

• ai: The model’s configuration options have been moved from config.ai.chat.models to config.ai.models to ensure consistent model configuration across all AI features. The model configuration is now applied uniformly in both AI Chat and AI Review Mode.

• ai: Upgrade fast-xml-parser to version 5.3.4 to address security advisories reported by automated scanners. CKEditor 5 does not rely on the affected code paths and is not impacted.

• icons: Added new icons: IconBoxWithCheck, IconBoxWithCross, IconBoxWithPin.

• import-word: Added the undoStepBatch property to the dataInsert event. It allows including custom model changes (side effects) in the same undo step as the import operation.

• Optimized compression and decompression mechanisms used in real-time collaboration to avoid delays when a user joins a document that was heavily edited.

• Update diff dependency to address security advisories reported by automated scanners.

  The affected functions (parsePatch(), applyPatch()) are not used in this project (we only rely on diffArrays()), so this change is released primarily to reduce false-positive security alerts.

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

This is a minor update focused on improving content editing workflows and data compatibility. We are introducing better visualization for table borders, enhanced image alignment handling, and several improvements to AI and email features.

We are introducing an experimental tableCellTypeSupport flag that enables changing table cell types between data and header cells (th). This feature provides more flexibility when working with complex table structures. Read more about how to enable it in the update guide.

We are introducing a new config.table.showHiddenBorders configuration option (enabled by default) that helps editors work with tables that have hidden borders. When the editor detects inline border:none or border-style:none declarations on table and cell elements, it renders dashed helper borders in the editing view. This makes it easier to see the table structure while editing without affecting the output data. For strict WYSIWYG scenarios where you want the editing view to match the output exactly, this visualization can be disabled.

We improved the email styles transformation with better appearance of resized inline images in classic Outlook clients. Additionally, the new optional useFigureToTableFallback flag in the email styles transformers can replace figure (block images) with tables to improve alignment and width handling in older email clients with limited CSS support.

• Fixed multiple issues in the AI features, including improved tooltips for web search sources in AI Chat, proper handling of Quick Actions when opening the AI Chat panel, resolved loading state issues in the AI Review sidebar, and others.
• The editor now recognizes CSS float style on images (e.g., style="float: left" or style="float: right") and automatically maps it to left/right image alignment. This works for both inline and block images, improving compatibility when pasting content from external sources or loading legacy content. If custom image styles are configured, they take precedence over the float style.
• The Emoji plugin can now be used with the Emoji v17.0 dataset, which has been uploaded to the CKEditor CDN. This update does not change the default emoji version used by CKEditor.

Please note that the old installation methods will only remain available up to CKEditor 5 v48.0.0, which is planned for release at the beginning of Q2 2026. For more timeline details, refer to the dedicated GitHub issue.

In CKEditor 5 v42.0.0 in June 2024, we introduced new installation methods designed to improve and simplify the developer workflow. Soon, they will be the only available paths to install and use CKEditor 5.

If your project still relies on old installation methods, now is a good time to plan your next steps. We recommend choosing between these two options:

1. Migrate to the new installation methods, which are the recommended path for most users. The new installation methods provide a cleaner setup, easier upgrades, and better alignment with future CKEditor 5 releases.
2. Consider CKEditor 5 Long Term Support (LTS). If migrating in the near term is not feasible, you can extend support for legacy installation methods.

• table, theme-lark: Added support for visualizing hidden table and table cell borders through a new configuration option: table.showHiddenBorders (enabled by default). The editor now detects inline border:none and border-style:none declarations on table and cell elements and renders dashed helper borders in the editing view. This visualization can be disabled for strict WYSIWYG scenarios. Closes #19039.

• ai: Added a new tooltip for web search sources in the AI Chat.

  The tooltip now displays the full link, favicon, and link title.

• email: Added an inline-styles transformation that improves the appearance of resized inline images in classic Outlook clients.

  Additionally, introduced an optional useFigureToTableFallback flag in the email inline-styles transformers. When enabled, figures (block images) are replaced with tables to improve alignment and width handling in older email clients that have limited CSS support. This enhances compatibility but adds extra markup, which may affect layout in some cases.

• emoji: The Emoji plugin can now be used together with the Emoji v17.0 dataset, which has been uploaded to the CKEditor CDN. This update does not change the default emoji version used by CKEditor. Closes #19394.

• basic-styles, icons: Fixed the superscript and footnote icons to properly inherit colors from CSS instead of using hardcoded fill values. Closes #19464.

• email, export-inline-styles: Fixed incorrect table alignment in Classic Outlook when exporting inline styles with getEmailInlineStylesTransformations.

• paste-from-office, table: The editor no longer crashes when calling getData() on content containing a table with custom styling, provided that the TablePropertiesEditing and PlainTableOutput plugins are loaded without the TableProperties plugin. Closes #19512.

• code-block, typing: Fixed an error thrown when creating a code block via backticks on some keyboard layouts (e.g. US International). Closes #18926.

• engine, undo: Fixed a bug where undoing changes to root attributes (e.g. the order attribute) would not restore the correct value. Closes #19483.

• ai: AI Review sidebar is no longer stuck in loading state for specific AI API responses with no real changes in the content.

• ai: AI Chat related Quick Actions now open the AI Chat if it is closed or if another tab is currently active.

• ai: The AI feature now functions correctly when used with the Title plugin.

• ai: The document will no longer be added to the context automatically when it is disabled via the ai.chat.context.document.enabled config.

• ai: Quick Actions that use AI Chat are now hidden when the document context is disabled via the ai.chat.context.document.enabled config, as they require the document to function properly.

• ai: Editor toolbar is now always visible when AI Review suggestion is accepted or dismissed.

• footnotes: The footnotes’ definitions are no longer lost when pasting content that lacks the application/ckeditor5-footnotes data but contains footnote references and definitions. The plugin now extracts and merges footnote definitions from the pasted content, ensuring that existing footnotes are preserved and new ones are added correctly.

• image: The editor and its UI now recognize the CSS float style on images (e.g. style="float: left" or style="float: right") and map it to left/right image alignment. This applies to both inline and block images. If custom image styles are configured, then the float style is ignored. Closes #19521.

• link: Fixed an issue where setting editor data with multiple images or images mixed with text inside a single link would result in only the first image being preserved and the rest of the content being removed. Closes #18961.

• media-embed: Added a strict-origin-when-cross-origin attribute to the iframe tag when embedding YouTube videos. It corresponds with the YouTube documentation and resolves occurrences of error 153 when embedding YouTube videos.

  Thanks to @ampaze.

• pagination: Fixed a crash in pagination that occurred when a to-do list item was the first element in the editor.

• pagination: Fixed an issue with the incorrect order of page breaks for tables containing specific data.

• revision-history: Stopped the revision history loading overlay spinner from animating while hidden. Closes ckeditor/ckeditor5#19558.

• table: Fixed incorrect table rows moving as header row when preceding rows are not header rows. Closes #19431.

• table: The default alignment for table headers in the output has been set to left to match the editing view and ensure consistent rendering across all browsers. Closes #19454.

• typing: Disable text transformations inside inline code so automatic text transformation does not convert typed text. Closes #19557.

• ui: Guarded dropdown panel selection handling against non-element targets to avoid errors when selecting text. Closes #19565.

• ai: The Track Changes suggestion markers are always grayed out in AI review, even if active.

  This makes it easier to navigate when review check is active in content with many Track Changes suggestions and keeps full focus on changes created by AI.

• ai: AI models displayed in Review and Chat are now sorted by their model family.

• core: The Editor class constructor now detects if the provided EditorConfig is not an object. Closes #18072.

  The common source of this error is when an editor class (e.g., ClassicEditor) is mistakenly included in the plugins list when initializing Editor.

• table: Introduced the experimental tableCellTypeSupport flag to enable changing table cell types between data and header. To use this change, besides the flag, the TablePropertiesUIExperimental and TableCellPropertiesUIExperimental plugins must be used. See #16730.

• Removes operation and time limits from trial license.

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.

  The TableProperties and TableCellProperties plugins already include their standard UI counterparts (TablePropertiesUI and TableCellPropertiesUI). To avoid conflicts, when using experimental UI plugins, you must load the editing plugins (TablePropertiesEditing, TableCellPropertiesEditing) and the experimental UI plugins separately, instead of using the “glue” plugins.

  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: Introduced the experimental useExtendedTableBlockAlignment flag enabling block table alignments. Updated table balloons to reflect this behavior and better match the editor design, visible when using the new TablePropertiesUIExperimental and TableCellPropertiesUIExperimental plugins. See #3225.

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