Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

ckeditor4-react

ckeditor137.2kSEE LICENSE IN LICENSE.md5.2.1TypeScript support: included

Official React component for CKEditor 4 – the best browser-based rich text editor.

wysiwyg, rich text, editor, html, contentEditable, editing, react, react-component, react-hooks, react hooks, ckeditor, ckeditor4, ckeditor 4

readme

CKEditor 4 WYSIWYG editor component for React Tweet

npm version GitHub tag

Build Status

Join newsletter Follow Twitter

⚠️ CKEditor 4: End of Life and Extended Support Model until Dec 2028

CKEditor 4 was launched in 2012 and reached its End of Life (EOL) on June 30, 2023.

A special edition, CKEditor 4 LTS ("Long Term Support"), is available under commercial terms ("Extended Support Model") for anyone looking to extend the coverage of security updates and critical bug fixes.

With CKEditor 4 LTS, security updates and critical bug fixes are guaranteed until December 2028.

About this repository

Master branch = CKEditor 4 LTS React Component

After June 30, 2023 the master version of the LICENSE.md file changed to reflect the license of CKEditor 4 LTS available under the Extended Support Model.

This repository now contains the source code of CKEditor 4 LTS React Component that is protected by copyright law.

Getting CKEditor 4 (Open Source)

You may continue using CKEditor React Component 4.3.0 and below under the open source license terms. Please note, however, that the open source version no longer comes with any security updates, so your application will be at risk.

In order to download the open source version of CKEditor 4 React Component, use tags 4.3.0 and below. CKEditor React Component 4.3.0 was the last version available under the open source license terms.

About this package

Official CKEditor 4 WYSIWYG editor component for React.

We are looking forward to your feedback! You can report any issues, ideas or feature requests on the integration issues page.

CKEditor 4 screenshot

Usage

import React from 'react';
import { CKEditor } from 'ckeditor4-react';

function App() {
    return <CKEditor initData="<p>This is an example CKEditor 4 WYSIWYG editor instance.</p>" />;
}

export default App;

Documentation and examples

See the CKEditor 4 WYSIWYG Editor React Integration article in the CKEditor 4 documentation.

You can also check out CKEditor 4 WYSIWYG Editor React Integration example in CKEditor 4 Examples.

For even more examples, check out ready-to-fork samples inside samples directory. Each sample is a self-contained app that can be forked via GitHub or via services such as CodeSandbox. For instance, in order to clone basic sample, use this link.

React support

The CKEditor 4 React integration was tested with React 18.

TypeScript support

TypeScript 3.5+ is supported.

Browser support

The CKEditor 4 React integration works with all the supported browsers except for Internet Explorer.

Previous versions of ckeditor4-react also support Internet Explorer 11 (requires additional polyfill for Promise).

Contributing

See CONTRIBUTING.md.

License

Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.

For full details about the license, please check the LICENSE.md file.

CKEditor 4 React Component 4.3.0 and below for CKEditor 4 Open Source

Licensed under the terms of any of the following licenses at your choice:

CKEditor 4 React Component 5.0 and above for CKEditor 4 LTS ("Long Term Support")

CKEditor 4 LTS React Component (starting from version 5.0) is available under a commercial license only.

changelog

CKEditor 4 WYSIWYG Editor React Integration Changelog

⚠️️️ CKEditor 4 (the open source edition) is no longer maintained. ⚠️

If you would like to keep access to future CKEditor 4 security patches, check the Extended Support Model, which guarantees security updates and critical bug fixes until December 2028. Alternatively, upgrade to CKEditor 5.

ckeditor4-react 5.2.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.25.1-lts.
  • Updated license headers to 2025.
  • Updated readme files to reflect the new CKEditor 4 Extended Support Model end date.

Please note that this patch release doesn't provide any security fixes. It's a part of our administrative maintenance updates.

ckeditor4-react 5.2.0

⚠️️️ CKEditor 4 CDN dependency has been upgraded to the latest secure version. All editor versions below 4.25.0-lts can no longer be considered as secure! ⚠️

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.25.0-lts.

ckeditor4-react 5.1.0

⚠️️️ CKEditor 4 CDN dependency has been upgraded to the latest secure version. All editor versions below 4.24.0-lts can no longer be considered as secure! ⚠️

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.24.0-lts.

ckeditor4-react 5.0.0

This release introduces a support for the LTS (”Long Term Support”) version of the editor, available under commercial terms ("Extended Support Model").

If you acquired the Extended Support Model for CKEditor 4 LTS, please read the CKEditor 4 LTS key activation guide.

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.23.0-lts.

ckeditor4-react 4.3.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.22.1.

ckeditor4-react 4.2.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.21.0.

ckeditor4-react 4.1.2

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.20.2.

ckeditor4-react 4.1.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.20.1.

ckeditor4-react 4.1.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.20.

ckeditor4-react 4.0.0

Highlights

The v4.0.0 release introduces support for React v18. You can read more about these changes in the React v18 release notes.

Due to significant changes in React v18, the integration with CKEditor 4 is no longer compatible with the previous versions of React. Please note that this version of React also drops support for Internet Explorer 11.

If you don’t want to lose support for IE11 or you haven't moved to React v18 yet, make sure to use React integration in version 3.

See the browser compatibility table to learn more about supported browsers and React versions.

BREAKING CHANGES:

  • #284: Add support for React 18 and remove support for older versions of React.

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.19.1.

ckeditor4-react 3.1.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.19.0.

ckeditor4-react 3.0.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.18.0.

    Web Spell Checker ended support for WebSpellChecker Dialog on December 31st, 2021. Therefore, this plugin has been deprecated and removed from the CKEditor 4.18.0 standard-all preset. We strongly encourage everyone to choose one of the other available spellchecking solutions - Spell Check As You Type (SCAYT) or WProofreader.

ckeditor4-react 2.1.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.17.2.
  • Updated year and company name in the license headers.

ckeditor4-react 2.1.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.17.1.

ckeditor4-react 2.0.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.16.2.

ckeditor4-react 2.0.0

New Features:

  • #228: Added support for setting editor's initial data as HTML string.

ckeditor4-react 2.0.0-rc.2

BREAKING CHANGES:

  • #226: Updated ckeditor4-integrations-common dependency to version 1.0.0.

ckeditor4-react 2.0.0-rc.1

Other Changes:

  • Added CHANGELOG entries for RC versions.
  • Improved project README.

ckeditor4-react 2.0.0-rc.0

BREAKING CHANGES:

  • #124: Introduced support for React hooks and rewrote the component to use hooks internally.

New Features:

  • #159: Introduced support for React 17+ versions.
  • #82: Introduced TypeScript support.
  • #180: Introduced support for consumption of a not bundled package version by providing package in ESM, CJS and UMD formats.

ckeditor4-react 1.4.2

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.16.1.

ckeditor4-react 1.4.1

Fixed Issues:

ckeditor4-react 1.4.0

Other Changes:

ckeditor4-react 1.3.0

New Features:

ckeditor4-react 1.2.1

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.15.1.

ckeditor4-react 1.2.0

Fixed Issues:

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.15.0.

ckeditor4-react 1.1.1

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.14.1.

ckeditor4-react 1.1.0

Fixed Issues:

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.14.0.

ckeditor4-react 1.0.1

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.13.1.

ckeditor4-react 1.0.0

New Features:

  • #15: Introduced support for Server Side Rendering.

Fixed Issues:

  • #46: Fixed: The React integration tries to destroy a non-existent editor instance in some cases. Thanks to Oleg Kachmar!
  • #44: Fixed: An error thrown when changing routes quickly.
  • #49: Fixed: A "Cannot read property 'getEditor' of null" error thrown when the component is unmounted.
  • #56: Fixed: CKEditor crashes when unmounting with a "Cannot read property 'destroy' of null" error.

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.13.0.

ckeditor4-react 1.0.0-beta.2

New Features:

  • #47: Exposed the CKEDITOR namespace before loading the editor instance. Thanks to Nick Rattermann!
  • #48: Added CKEDITOR.displayName for easy debugging and testing. Thanks to Florent Berthelot!

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.12.1.

ckeditor4-react 1.0.0-beta

Other Changes:

  • Updated the LICENSE.md file with all development and production dependencies.

ckeditor4-react 0.1.1

Other Changes:

  • Updated all CKEditor 4 dependencies to the 4.11.4 version.
  • README.md file improvements.

ckeditor4-react 0.1.0

The first beta release of the CKEditor 4 WYSIWYG Editor React Integration.