Skip to content

Releases: ckeditor/ckeditor5

v47.6.1

11 Mar 08:28
v47.6.1
4da6cfc

Choose a tag to compare

We are releasing CKEditor 5 v47.6.1, a patch that fixed three regressions discovered after v47.6.0.

Bug fixes

  • engine, undo: Fixed undo marker restoration for markers spanning multiple paragraphs. Previously, comments and suggestions could be restored to incorrect ranges. Closes #19916.
  • ai: Resolved an issue where AI Chat would crash when attempting to open a past conversation that was created by a model no longer available.
  • widget: Fixed a regression where the caret (|) jumped over an empty paragraph when navigating with arrow keys near widgets. Closes #19812.

Released packages

Check out the Versioning policy guide for more information.

Released packages (summary)

Other releases:

Read more

v47.6.0

04 Mar 08:23
v47.6.0
8d55539

Choose a tag to compare

We are excited to announce the release of CKEditor 5 v47.6.0.

Security update

A Cross-Site Scripting (XSS) vulnerability has been discovered in the General HTML Support feature (CVE-2026-28343). This vulnerability could be triggered by inserting specially crafted markup, leading to unauthorized JavaScript code execution if the editor instance used an unsafe General HTML Support configuration.

This vulnerability affects only installations where the editor configuration meets the following criteria:

You can read more details in the relevant security advisory and contact us if you have more questions.

Release highlights

This release introduces new list indentation capabilities and expands the customization options for CKEditor AI, giving integrators more control over the AI-powered editing experience.

⭐ CKEditor AI On-premises available

CKEditor AI is now available as an on-premises deployment, giving you full control over the AI service by running it on your infrastructure. The on-premises version supports everything the cloud option offers, plus:

  • Custom AI models and providers — use your models from OpenAI, Google Cloud, Microsoft Azure, or self-hosted solutions.
  • MCP (Model Context Protocol) support — extend the AI with custom external tools by connecting MCP servers, enabling use cases like searching internal knowledge bases or querying company databases directly from the AI chat.

Learn more about deployment options and MCP support.

⭐ Custom AI Review checks

The AI Review feature now supports custom review commands defined by integrators. Until now, the review was limited to built-in commands like proofreading, clarity, readability, and tone adjustment. With this release, you can create review commands tailored to your editorial guidelines, brand voice, or domain-specific quality standards.

Custom commands are registered via config.ai.review.extraCommands and made visible in the UI through config.ai.review.availableCommands. The same option lets you reorder, filter, or shorten the list of built-in commands to match your needs. See the documentation for details.

⭐ AI Chat Shortcuts

We are introducing AI Chat Shortcuts, a new opt-in plugin that displays configurable shortcut buttons in the AI Chat panel before the first message is sent. Shortcuts provide clear, actionable entry points that guide users toward the most useful AI capabilities. From launching a predefined prompt to starting a specific review or translation flow to navigating directly to the Review or Translate tab.

Integrators define shortcuts with a name, icon, and an action. Each shortcut can also configure which AI capabilities (model, web search, reasoning) are active for the prompt. Learn more in the documentation.

List indentation improvements

We're streamlining and standardizing the way list indentation is handled. With improved UX, it's now possible to indent whole lists and also individual list items with consistent styling and no custom implementation required.

This improvement is compatible with Paste from Office, Export to Word, Export to PDF, and Track Changes plugins. It also provides RTL support.

Upgrade @aws-sdk/client-bedrock-runtime to the latest version

We upgraded @aws-sdk/client-bedrock-runtime to the latest version to address a recently disclosed security vulnerability in the fast-xml-parser dependency. We marked this update as a minor breaking change due to the use of dynamic imports in one of the underlying packages, which may impact certain build environments.

Warning

The action is required only if you use the legacy CKEditor AI Assistant with a dedicated editor bundle.

If you use webpack to build an editor bundle, configure it to bundle dynamic imports eagerly:

module: {
  parser: {
    javascript: {
      dynamicImportMode: 'eager'
    }
  }
}

If you do not use CKEditor AI with a dedicated bundle, no action is required.

Incoming old installation methods sunset reminder

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.

MINOR BREAKING CHANGES ℹ️

  • ai: Simplified the default greeting message shown when starting a new AI Chat conversation. To restore the previous message content, set config.ai.chat.welcomeMessage to the following:

    "Hi, I'm your AI assistant. Think of me as your writing buddy, reviewer, or research partner. I can suggest changes to your document, help generate ideas, offer feedback, discuss attached files, and much more!"

  • ai: Updated @aws-sdk/client-bedrock-runtime to version 3.994.0. This update introduced dynamic imports in a dependency, which may affect some build environments.

Features

  • ai: Added the config.ai.review.availableCommands configuration option to customize which review commands are shown in the AI Review tab.

  • ai: Introduced the AIChatShortcuts plugin, which displays configurable shortcuts in the AI Chat feed when starting a new conversation.

  • ai: Added support for custom AI Review commands. Custom commands can now be configured using config.ai.review.extraCommands.

  • export-pdf: Added the enable_mirror_margins option to the V2 PDF export converter API, allowing margins to alternate between odd and even pages for double-sided layouts.

  • html-support: Added support for the [sandbox] attribute on <iframe> elements rendered in the editing view. Filtering rules can be adjusted using the htmlSupport.htmlIframeSandbox configuration option.

  • indent: Added list indentation integration to the IndentBlock feature (enabled by default). Closes #19490.

    Added commands for whole-list indentation (indentBlockList and outdentBlockList) and list-item indentation (indentBlockListItem and outdentBlockListItem). Indentation can be rendered using margin-left/margin-right styles (offset-based) or CSS classes (class-based).

  • list: Added support for the arabic-indic list style type in the list properties plugin. Closes #19802.

Bug fixes

  • ai: Fixed an issue where using DLLs for the AI package together with the TrackChanges plugin could fail due to a SuggestionConversion plugin conflict.
  • ai: Fixed an issue where AI Quick Actions content overflowed in the preview window.
  • ai: Starting or loading an AI chat conversation no longer closes unrelated open dialogs in the editor.
  • ai: Displayed the Selected content label instead of "" when the Ask AI action is used on selections that include non-text content, such as an image without a caption.
  • ai: Displayed text from all selected table cells ...
Read more

v47.5.0

11 Feb 08:15
v47.5.0
ccb6844

Choose a tag to compare

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

Release highlights

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.

AI Translate

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.

Multiple Changes revamp and other AI improvements

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.

Export to PDF v2

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.

Incoming old installation methods sunset reminder

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.

MINOR BREAKING 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.

Features

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

Bug fixes

  • 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](...
Read more

v47.4.0

14 Jan 08:31
v47.4.0
46f97e4

Choose a tag to compare

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

Release highlights

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.

Experimental table cell type support

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.

Hidden table borders visualization

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.

Email compatibility improvements

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.

Other improvements and fixes

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

Incoming old installation methods sunset reminder

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.

Features

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

Bug fixes

  • 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](https://www....
Read more

v47.3.0

03 Dec 08:41
v47.3.0
fcab29b

Choose a tag to compare

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

Release highlights

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

CKEditor AI improvements and bug fixes

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.

New experimental options

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.

Features

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

Bug fixes

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

Other changes

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

Read more

v47.2.0

05 Nov 08:21
v47.2.0
140627d

Choose a tag to compare

Release highlights

CKEditor AI

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.

Footnotes (⭐)

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 for blocks (⭐)

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.

Old installation methods sunset timelines

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.

Other improvements and fixes

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.

Features

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

Bug fixes

  • 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](#1921...

Read more

v47.1.0

16 Oct 07:33
v47.1.0
4f768f9

Choose a tag to compare

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

Release highlights

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

MINOR BREAKING CHANGES ℹ️

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

Note

Breaking changes in CKEditor AI are permitted during the Active phase of an LTS release. Learn more why.

Features

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

Bug fixes

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

Other changes

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

Released packages

Check out the Versioning policy guide for more information.

Released packages (summary)

Minor releases (contain minor breaking changes):

Other releases:

Read more

v47.0.0

01 Oct 09:50
v47.0.0
0c02152

Choose a tag to compare

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

Release highlights

CKEditor AI (early access)

We are introducing CKEditor AI, a set of versatile AI-powered features that integrate directly into CKEditor 5. It brings generation, summarization, correction, contextual chat help, reviews, and many other capabilities, right into the editor. With CKEditor AI, users will no longer need to switch between the editor and AI tools.

Three features are available in this early access phase:

  • Chat: a conversational AI for dynamic, multi-turn interactions that support various context sources, model selection, which can perform changes directly on the document.
  • Quick actions: one-click transformations and instant insights for selected text.
  • Review: automatic checks for grammar, tone, correctness, style, and more, with UX optimized for performing full-document review.

Each feature is powered by our state-of-the-art AI service, available in the Cloud today and coming soon for on-premises deployments. This makes CKEditor AI a true plug-and-play solution that works out of the box, eliminating the need for months of custom development.

CKEditor AI is available as part of our free trial in early access.

Long-term Support (⭐)

We are introducing the CKEditor 5 LTS (Long-term Support) Edition, giving teams up to 3 years of stability with guaranteed updates.

The first LTS release is v47.0.0 (October 2025). It will receive 6 months of active development with new features and fixes, then 2.5 years of maintenance with security and critical compatibility updates.

For v47.x, the Maintenance phase starts in April 2026. From then, the next versions in the v47.x line will be available only under a commercial LTS Edition license. Therefore, starting in April, integrators without an LTS license should migrate to v48.x (the next regular release).

If you need long-term stability, contact sales or read more about CKEditor 5 LTS Edition.

Other improvements and fixes

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

  • Widgets: the default Tab/Shift+Tab navigation now works better inside nested editables, improving usability. This change is also reflected in the editor’s current widgets (like tables), leading to more intuitive keyboard navigation.
  • UI: dialogs in custom features can now be positioned programmatically with more flexible options (Dialog#show()).
  • Comments: confirmation views for deleting comments and threads now use simplified CSS selectors (.ck-confirm-view). You may need to adjust custom styles accordingly.

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

MAJOR BREAKING CHANGES ℹ️

  • ai: Due to the release of the new AI feature, the ai.* configuration structure has changed. Until now, the configuration object was used for the former AIAssistant feature. Now, this configuration space is used for all AI related features. Configuration for the AIAssistant was moved. The changes are:
    • ai.aiAssistant -> ai.assistant,
    • ai.useTheme -> ai.assistant.useTheme,
    • ai.aws -> ai.assistant.adapter.aws,
    • ai.openAI -> ai.assistant.adapter.openAI.

MINOR BREAKING CHANGES ℹ️

  • table, widget: The Widget feature implements the default handling for Tab/Shift+Tab to navigate nested editable elements in the editor content. Closes #19083. The listeners are registered on the low priority bubbling event in the context of widgets and editable elements. Please verify if your custom Tab/Shift+Tab handling does not collide with the default one.
  • ai: The internal structure of the package has changed. Importing AIAssistant from the source should be done via @ckeditor/ckeditor5-ai/src/aiassistant/aiassistant.js path instead of the previous @ckeditor/ckeditor5-ai/src/aiassistant.js.
  • comments: Changed the CSS selectors used to style the confirmation view displayed when attempting to remove a comment or an entire comment thread. For now, CSS classes will be more generic, for example: .ck-confirm-view instead of .ck-thread__remove-confirm. If you override styles for these components, you will need to update the selectors.
  • undo: The UndoCommandRevertEvent type was renamed to UndoRedoBaseCommandRevertEvent and moved to the basecommand.ts file. Adjust your code if you have used this type in your custom integration. See #19168.
  • Updated to TypeScript 5.3.

Features

  • ai: Introduced CKEditor AI, a brand-new set of versatile AI-powered features, including: chat, quick actions, and document review capabilities.
  • ui: The position parameter in Dialog#show() now can be a function that takes dialogRect and domRootRect parameters and should return an object with top and left properties or null. It can be used to specify a custom positioning for the dialog. Closes #19167.

Bug fixes

  • engine: The markerToHighlight() converter did not clone the view configuration if passed as plain object leading to incorrect behavior. This affects only custom plugins that used this converter in the described way. Closes #19105.

  • engine: The bubbling events now trigger event callbacks according to the registered priorities even if multiple custom contexts are provided. See #19083.

  • export-inline-styles: Fix specificity calculation to handle :where() selectors correctly.

  • link: The link manual decorators are no longer lost when caption is added to an image. Closes #19024.

  • pagination: Pagination lines should calculate properly for pages with larger horizontal margins.

  • revision-history: Fixed a crash which happened under specific circumstances when a revision was created when document was exported using the Cloud Services REST API (GET /documents/ endpoint).

    Although the fix was necessary in Revision History feature code, it was only reproducible in scenarios involving using the mentioned export endpoint.

Other changes

  • comments: Corrected types for the resolvedBy parameter in CommentThread#resolve. It was previously typed as undefined | null, and is now properly typed as undefined | string.
  • undo: RedoCommand will now fire 'revert' event when executed, similarly to UndoCommand. Type UndoCommandRevertEvent was renamed to UndoRedoBaseCommandRevertEvent and moved to basecommand.ts file. Closes #19168.

Released packages

Check out the Versioning policy guide for more information.

Released packages (summary)

Major releases (contain major breaking changes):

Minor releases (contain minor breaking changes):

Releases containing new features:

Other releases:

Read more

v46.1.1

15 Sep 07:59
v46.1.1
9acd47f

Choose a tag to compare

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

Release highlights

This is an internal release focused on improving our development infrastructure and the release process. These changes have no impact on integrators but represent significant improvements to our development workflow.

Development environment modernization

We have migrated our package management from Yarn Classic to pnpm, delivering substantial benefits:

  • Faster installations through efficient linking mechanisms,
  • Improved dependency management with stricter resolution and better peer dependency handling,
  • Better disk efficiency by eliminating duplicate packages across projects.

We have also introduced dependency locking mechanisms that provide greater stability and predictability in our build process, ensuring consistent environments across development setups and CI/CD pipelines.

What this means for you

As an integrator, you will not notice any changes in functionality or API. This release maintains full backward compatibility while laying the foundation for more efficient development cycles and faster future releases.

If you fork the repository and develop using source code, you will need to update your development setup according to our development environment guide.

Released packages

Check out the Versioning policy guide for more information.

Released packages (summary)

Minor releases (contain minor breaking changes):

Releases containing new features:

Other releases:

Read more

v46.1.0

10 Sep 07:23
v46.1.0
c44bb91

Choose a tag to compare

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

Release highlights

Smoother drag & drop of widgets on iOS

We updated the implementation for more reliable drag-and-drop on iOS touch devices. The behavior on the desktop devices remains unchanged.

Pagination improvements

We reverted a low-level change to improve stability in pagination, especially in scenarios including long tables.

Hide a user in the Server-side editing API

The Server-side editor API now supports a hidden_in_presence_list user flag. You can use this mechanism to prevent automation script users from appearing in the editor’s presence list while scripts run.

Comments’ markers clean up

We provided a better handling of edge cases where a marker points to a non-existing comment thread (for example, due to integrator mistakes). Such markers are now removed automatically to keep the editor stable.

MINOR BREAKING CHANGES ℹ️

  • real-time-collaboration: CloudServicesCommentsAdapter#getCommentThread no longer throws an error when a comment thread does not exist. Instead, it now returns null.

Features

  • real-time-collaboration: The user will not be displayed in the Presence List when a server-side editor API script is executed with the hidden_in_presence_list parameter.
  • table: The table caption feature now has a configuration option table.tableCaption.useCaptionElement that changes the HTML for table captions. With this option set to true the output HTML for table caption changes from figure.table > figcaption to figure.table > table > caption. Closes #18988.

Bug fixes

  • clipboard, engine, widget: Improved drag & drop of widgets with selection handle on iOS devices. Closes #16335.
  • engine: Spaces at the end of list items are correctly preserved when saving and loading data. Closes #18960.
  • engine: Fixed an issue where the editor could crash if the selection was moved to a non-existent node during the blur event. Closes #18744.
  • merge-fields: Editor no longer incorrectly adds an empty paragraph (that does not exist in data) when loaded data contains a block merge field with a marker (such as comment) on it.
  • pagination: Adjusted theme for <caption> vs <figcaption> element in tables. See ckeditor/ckeditor5#18988.
  • paste-from-office: Ensure consistent formatting of content pasted from Google Docs by replacing tab characters with spaces in preformatted text blocks. Closes #18995.
  • revision-history: Fixed an error that prevented previewing a revision that included a removed block merge field.
  • uploadcare: Fixed an issue where the Uploadcare image uploader and editor did not work correctly with custom upload URLs or custom CDN canonical names.
  • watchdog: Fixed an issue where Watchdog incorrectly restored collaboration data (comment threads and suggestions) after a crash in load and save integrations. Closes #19033.
  • widget: Read-only mode no longer focuses the editor and displays UI when selecting nested editables. Closes #18965.

Other changes

  • comments, real-time-collaboration: Comment markers linked to non-existing threads are now removed automatically (instead of throwing an error) in real-time collaboration, ensuring the editor remains fully functional.
  • track-changes: Error track-changes-user-not-found will now be thrown with additional data to help with debugging: authorId (the ID of the missing user) and suggestionId (the ID of the suggestion for which the error was thrown).

Released packages

Check out the Versioning policy guide for more information.

Released packages (summary)

Minor releases (contain minor breaking changes):

Releases containing new features:

Other releases:

Read more