What is @ckeditor/ckeditor5-core?
@ckeditor/ckeditor5-core is a core package for CKEditor 5, a modern JavaScript rich text editor. It provides essential functionalities and utilities for building and customizing CKEditor 5 editors.
What are @ckeditor/ckeditor5-core's main functionalities?
Editor Creation
This feature allows you to create and initialize a CKEditor 5 instance. The code sample demonstrates how to create a classic editor and attach it to a DOM element.
const ClassicEditor = require('@ckeditor/ckeditor5-editor-classic/src/classiceditor');
const Editor = require('@ckeditor/ckeditor5-core/src/editor/editor');
ClassicEditor.create(document.querySelector('#editor'))
.then(editor => {
console.log('Editor was initialized', editor);
})
.catch(error => {
console.error(error.stack);
});
Plugin Management
This feature allows you to create and manage plugins for CKEditor 5. The code sample demonstrates how to create a custom plugin and include it in the editor configuration.
const Plugin = require('@ckeditor/ckeditor5-core/src/plugin');
class MyPlugin extends Plugin {
init() {
console.log('MyPlugin was initialized');
}
}
ClassicEditor.create(document.querySelector('#editor'), {
plugins: [ MyPlugin ]
})
.then(editor => {
console.log('Editor with MyPlugin was initialized', editor);
})
.catch(error => {
console.error(error.stack);
});
Command Management
This feature allows you to create and manage commands in CKEditor 5. The code sample demonstrates how to create a custom command and execute it within the editor.
const Command = require('@ckeditor/ckeditor5-core/src/command');
class MyCommand extends Command {
execute() {
console.log('MyCommand executed');
}
}
ClassicEditor.create(document.querySelector('#editor'))
.then(editor => {
editor.commands.add('myCommand', new MyCommand(editor));
editor.execute('myCommand');
})
.catch(error => {
console.error(error.stack);
});
Other packages similar to @ckeditor/ckeditor5-core
tinymce
TinyMCE is another popular rich text editor that provides a wide range of features and plugins. It is similar to CKEditor 5 in terms of functionality but has a different API and plugin system.
quill
Quill is a modern WYSIWYG editor built for compatibility and extensibility. It offers a simpler API compared to CKEditor 5 and is highly customizable through its modular architecture.
draft-js
Draft.js is a JavaScript rich text editor framework developed by Facebook. It provides a set of React components and an immutable model for managing editor state, making it different from CKEditor 5's approach.
CKEditor 5 core editor architecture

This package implements CKEditor 5's core editor architecture – a set of classes and interfaces which glue everything together.
Installation
This plugin is part of the ckeditor5
package. Install the whole package to use it.
npm install ckeditor5
Create free account
If you want to check full CKEditor 5 capabilities, sign up for a free non-commitment 14-day trial.
Documentation
For general introduction see the Overview of CKEditor 5 framework guide and then the core editor architecture guide.
Additionally, see the @ckeditor/ckeditor5-core
package page in CKEditor 5 documentation for even more information.
License
Licensed under a dual-license model, this software is available under:
For more information, see: https://ckeditor.com/legal/ckeditor-licensing-options.
45.0.0 (April 7, 2025)
The CKEditor 5 v45.0.0 release brings powerful new features and improvements, making content creation smoother and more versatile. From enhanced email editing to a refined linking experience and a brand-new full-screen mode, this update is packed with valuable upgrades.
Release highlights
Email editing enhancements
We are making it easier to create and edit emails directly in CKEditor 5 with several enhancements. This release introduces the following new features:
- Export with Inline Styles (⭐) provides the ability to export email content with automatically inlined styles, ensuring compatibility and proper rendering across different email clients.
- Email Configuration Helper (⭐) is a new configuration helper plugin that provides guidance for integrators to correctly set up an email-friendly editor while avoiding common pitfalls.
- Layout tables: are a new type of tables that has been introduced to simplify the creation of structured email designs, offering better control over layout, alignment and spacing.
Apart from these new features, this update also brings various fixes and improvements related to table behavior, enhanced HTML support, and better handling of complex email structures. These refinements help ensure a more seamless email editing experience, reducing inconsistencies and improving compatibility with external email clients.
The fullscreen feature
A long-requested feature has finally arrived with the introduction of full-screen editing for the classic and decoupled editor types. This new mode provides a focused writing experience by making the editor the centerpiece of the screen. The expanded screen space allows for better visibility of content in sidebars such as comments, suggestions, and document outlines, enhancing your overall workflow.
Improved linking experience
Linking in CKEditor 5 has been significantly upgraded with a redesigned user interface, making adding and editing links more intuitive. Users can now easily link to bookmarks within the document and select links from predefined lists (defined by the developer). These improvements make inserting and managing links faster and more flexible than ever before.
During this initiative, we also aligned visual and technical components of the editor. Each balloon got a header with the tile, we also unified the toolbar behavior and keystrokes of Link and Bookmarks with other widget’s toolbars like image and tables.
[!NOTE]
The UI got updated in several places: main view, link properties (decorators), and also its technical implementation changed. Make sure to give special attention to the update if you did any customizations to the link interface.
New installation methods improvements: icons replacement
We are continuing to strengthen the new installation methods while phasing out older solutions. We added one of the key components you asked for: replacing our icons with your custom ones. It is now possible to replace the icons via the package’s override mechanism.
[!NOTE]
To achieve a proper solution for icons replacement for the npm builds, we needed to introduce a breaking change. If you used our icons for any purposes, make sure to update their paths.
⚠️ Deprecations in old installation methods: stage 1 completed
We are progressing with deprecation according to our sunset plan. From this release, predefined builds’ packages, such as @ckeditor/ckeditor-build-classic
, are now officially deprecated. We also dropped support for Webpack 4 in both the old and new installation methods.
By the end of 2025, custom builds that rely on webpack and DLL builds will also be deprecated. Refer to our documentation and migration guides to ensure a smooth transition.
We are committed to making CKEditor 5 even better. Stay tuned for more improvements in upcoming releases! If you have any feedback, let us know — we are always listening.
Please refer to the update guide to learn more about these changes.
Happy editing!
MAJOR BREAKING CHANGES ℹ️
- bookmark: The
BookmarkUI#actionsView
is no longer available. The bookmark feature is now using the WidgetToolbarRepository
instead.
- build-*: CKEditor 5 predefined builds are no longer available.
- link: The
LinkUI#actionsView
is no longer available. The bookmark feature now uses the LinkUI#toolbarView
(an instance of the ToolbarView
class) instead of the custom LinkActionsView
.
MINOR BREAKING CHANGES ℹ️
- link: The
createBookmarkCallbacks()
helper is now replaced by the isScrollableToTarget()
and scrollToTarget()
helpers.
- table: The
FormRowView
class was moved to the @ckeditor/ckeditor5-ui
package.
- table: The
form.css
component was moved to the @ckeditor/ckeditor5-theme-lark
package.
- All CKEditor 5 icons are now available in the
@ckeditor/ckeditor5-icons
package.
Features
- email: Introduced a new package to validate the editor configuration for email compatibility. It helps prevent misconfigurations by enforcing best practices and future-proof rules. Added utilities for post-processing CSS, improving support across various email clients by adjusting styles for better rendering consistency.
- export-inline-styles: Added a new package for exporting content with inline styles. Ensures CSS classes (
[class]
) and IDs ([id]
) are inlined within elements, improving compatibility with email clients that strip external styles. It helps maintain consistent formatting across different email clients, reducing rendering issues.
- fullscreen: Introduced the fullscreen mode feature. Closes #18026. (commit)
- html-support: Introduced the ability to render the
<style>
elements from the <head>
section of editor data content using the FullPage
plugin. See #13482. (commit)
- revision-history: Added a new property
RevisionHistory#isRevisionViewerOpen
that indicates whether the revision history is opened or not.
- source-editing-enhanced: The one-dark theme is now built-in and available via
config.sourceEditingEnhanced.theme
by passing the 'dark'
value. This change enables the use of the dark theme with the CDN installation method, which does not support external CodeMirror
dependencies. Additionally, if you previously used the oneDark
extension directly, you can now switch to theme: 'dark'
for built-in support.
- table: Introduced the layout tables feature to enable constructing grids with tables, for example for email editing. These tables are designed for layout purposes, and include the
role="presentation"
parameter for accessibility. Users can insert layout tables via the editor toolbar and switch between content and layout tables. The editing view now closely matches the rendered output. Closes #18132. (commit)
- table: Added the ability to toggle between content tables and layout tables. Users can switch table types using a split button in the table properties UI. While captions and
<th>
elements may be lost, table structure remains intact. Closes #18131. (commit)
- table: Dragging and dropping a table into another table no longer merges them. Instead, the dropped table is placed as a whole inside the target cell. Pasting tables remains unchanged. Closes #18126. (commit)
- template: Inserting a template containing a table into another table no longer merges them. Instead, the template is placed as a whole inside the target cell. See #18126.
- theme-lark: Introduced the
form.css
component . (commit)
- ui: Added the
MenuBarView#disable()
and MenuBarView#enable()
methods. They disable/enable all top-level menus in menu bar. Closes #17940. (commit)
- ui: Added the
ToolbarView#switchBehavior()
method to switch toolbar behavior after the editor has been initialized. Closes #18159. (commit)
- ui: Introduced the
FormRowView
class. (commit)
- Moved all icons to the
@ckeditor/ckeditor5-icons
package. Related to #16546. (commit)
- Added the
@ckeditor/ckeditor5-icons
package to the core DLL package. (commit)
Bug fixes
- ckbox: Resolved an issue where images from private categories were not appearing in the selector. Closes #18044. (commit)
- emoji: Fixed the emoji panel not being visible while used in comments archive. Closes #17964. (commit)
- engine: The selection should not move to another table row while switching heading rows. Closes #17962. (commit)
- heading: Added the missing
converterPriority
type definition to HeadingOption
interface. Closes #18182. (commit)
- html-support: The floated tables are now loaded and showed as expected in the editor's view. Closes #18203. (commit)
- link: The
Autolink
feature will now correctly autolink http://localhost
and http://localhost:port
. Closes #18185. (commit)
- mention: Fixed the mention panel not being visible while used in comments archive. Closes #17964. (commit)
- revision-history: Revisions will now correctly retain data for HTML embed widget, as well as
<script>
and <style>
tags enabled by the General HTML Support feature. Before, when revision was saved, these elements were saved empty, and this lead to data loss when such revision was restored. Note, that this will not fix revisions that are already affected by this error.
- revision-history: Fixed a crash when viewing a revision which had an HTML comment node in its data (reproducible with General HTML Support plugin).
- revision-history: Fixed handling
UIElement
s and RawElement
s by revision history (may concern third-party custom plugins).
- revision-history: Fixed a crash when viewing a revision which had a collapsed marker in its data (may concern third-party custom plugins).
- table: Removed
[role="textbox"]
from the <td>/
<th>` editables. Windows Narrator no longer reads table dimensions as 0 by 0. Closes #16923. (commit)
- track-changes: The editor no longer crashes during initialization when the
ShiftEnter
plugin is removed.
- ui: Do not open disabled menu bar menu items on arrow down press. Closes #17915. (commit)
- ui: The
ButtonView#icon
property can now be set/reset after the button's first render. (commit)
- table: Widgets UI elements should be visible when they are inside tables. Closes #18268.
- table: Nested tables outline should not be cut of at the bottom during hovering. Closes #18262.
- link: Link balloon no longer disappears when scrolling the page slightly on iOS. Closes #18022.
Other changes
- bookmark: The Bookmark feature now uses the
WidgetToolbarRepository
instead of a custom ActionsView
to display the bookmark toolbar in the contextual balloon. The new toolbar uses components registered in the ComponentFactory
. (commit)
- bookmark: Form styles and structure are now unified with use of
ck-form
and ck-form__row
. (commit)
- collaboration-core: Translations are now supported in the date formatter used by comments and suggestions, allowing for localizing dates.
- engine: Added the read-only
DomConverter#domDocument
property. Closes #18146. (commit)
- image: Image and custom resize form styles and structure now unified with use of
ck-form
and ck-form__row
. (commit)
- link: The link feature now uses the
ToolbarView
instead of a custom LinkActionsView
to display the link toolbar in the contextual balloon. The new toolbar uses components registered in the ComponentFactory
. (commit)
- link: Form styles and structure are now unified with use of
ck-form
and ck-form__row
. (commit)
- real-time-collaboration: Added a more modern look to the presence list collapsed view (used when many users are connected to the document).
- revision-history: The document outline will now be hidden when the revision history is opened.
- source-editing: Document outline and annotations will now be hidden when editor is in source editing mode. Closes #17978. (commit)
- table: Extracted the
form.css
to @ckeditor/ckeditor5-theme-lark
package. (commit)
- table: Extracted the
FormRowView
to @ckeditor/ckeditor5-ui
package. (commit)
- ui: The
IconView
now throws a meaningful error if the provided icon content is not a valid SVG. (commit)
- widget: The
WidgetToolbarRepository#register()
now accepts a customized list of desired balloon positions. (commit)
- Added the
Belarusian
language translations for CKEditor 5. Huge thanks to @karavanjo. (commit)
- Upgraded the minimal version of Node.js to 20.0.0 due to the end of LTS. (commit)
- Updated TypeScript
target
to es2022
. Closes #17886. (commit)
- Replaced
lodash-es
with es-toolkit
. See #16395. (commit)
- The
@ckeditor/ckeditor5-build-*
packages are no longer maintained. (commit)
Released packages
Check out the Versioning policy guide for more information.
<details>
<summary>Released packages (summary)</summary>
New packages:
Major releases (contain major breaking changes):
Releases containing new features:
Other releases:
</details>