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

Package detail

ckeditor4-angular

ckeditor75.1kSEE LICENSE IN LICENSE.md5.2.1TypeScript support: included

Official CKEditor 4 component for Angular.

wysiwyg, rich text editor, rte, editor, html, contentEditable, editing, angular, angular5, ng, component, ckeditor, ckeditor4, ckeditor 4

readme

CKEditor 4 WYSIWYG editor Angular component Tweet

npm version GitHub tag CircleCI

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 Angular 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 Angular Component that is protected by copyright law.

Getting CKEditor 4 (Open Source)

You may continue using CKEditor Angular Component 4.0.1 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 Angular Component, use tags 4.0.1 and below. CKEditor Angular Component 4.0.1 was the last version available under the open source license terms.

About this package

Official CKEditor 4 WYSIWYG editor component for Angular.

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

In order to create an editor instance in Angular, install the ckeditor4-angular npm package as a dependency of your project:

npm install --save ckeditor4-angular

After installing, import CKEditorModule to your application:

import { CKEditorModule } from 'ckeditor4-angular';

@NgModule( {
    imports: [
        ...
        CKEditorModule,
        ...
    ],
    …
} )

You can now use the <ckeditor> tag in the component template to include the rich text editor:

<ckeditor data="<p>Hello, world!</p>"></ckeditor>

The data attribute used in the example above is responsible for setting the editor’s data.

Documentation and examples

See the CKEditor 4 Angular Integration article and Angular examples in the CKEditor 4 documentation.

Browser support

The CKEditor 4 Angular component works with all the supported browsers except for Internet Explorer 8-11.

Supported Angular versions

The integration can be used together with Angular at version 5.0.0 and higher. It is an implication of Angular metadata produced for this package by the Angular builder. Note that the package.json used in the main repository isn't published on NPM (the production one is present in src/ckeditor/package.json), so there are only a few peer dependencies:

  • @angular/core >= 5.0.0
  • @angular/common >= 5.0.0
  • @angular/forms >= 5.0.0

required by this package.

Contributing

Here is how you can contribute to the development of the component. Any feedback and help will be most appreciated!

Reporting issues and feature requests

All issues and feature requests should be reported in the issues section of the official GitHub repository for the CKEditor 4 Angular integration.

Development

Clone the CKEditor 4 Angular integration repository.

Once you have cloned it, install dependencies by running:

npm install

The structure of the repository

This repository contains the following code:

  • ./src/ckeditor contains the CKEditor component,
  • ./src/app is a demo application using the component.

Development server

Run ng serve to start the development server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Building samples

Run ng build to build the samples. The build artifacts will be stored in the samples/ directory.

Running unit tests

Run npm test to execute unit tests via Karma.

There are two options available to alternate the testing process:

  • url / u - pass custom URL to Karma, for example custom CKEditor 4 build.
  • watch / w - tell Karma to watch for changes.

For example:

npm run test -- -u http://localhost:5000/ckeditor.js -w

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Protractor.

Publishing

To build and publish the package, run npm run publish.

You can also manually build the package with npm run build-package which will be stored in dist/. Then you can publish it with npm publish dist/.

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 Angular Component 4.0.1 and below for CKEditor 4 Open Source

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

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

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

changelog

CKEditor 4 Angular 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-angular 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-angular 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-angular 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-angular 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-angular 4.0.0 / 4.0.1

BREAKING CHANGES:

The v4.0.1 release introduces compatibility with Angular v16+. Please note that this version of Angular no longer supports Internet Explorer 11.

If you want to maintain support for IE11 or haven't upgraded to Angular v16 yet, make sure to use the Angular integration in version 3.3.0.

Other Changes:

  • #242: Updated the minimal version of Angular to ^13.4.0 to ensure compatibility with Angular 16+. Thanks to Moez Mehri!
  • Updated default CDN CKEditor 4 dependency to 4.22.1.

Note: Version 4.0.1 includes a patch for the distribution bundle that fixes missing support for Angular v16+ and should be used instead of v4.0.0 if you target a newer version of Angular.

ckeditor4-angular 3.3.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.21.0.

ckeditor4-angular 3.2.2

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.20.2.

ckeditor4-angular 3.2.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.20.1.

ckeditor4-angular 3.2.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.20.

ckeditor4-angular 3.1.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.19.1.

ckeditor4-angular 3.1.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.19.0.

ckeditor4-angular 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-angular 2.4.1

Other Changes:

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

ckeditor4-angular 2.4.0

New Features:

ckeditor4-angular 2.3.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.17.1.

ckeditor4-angular 2.2.2

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.16.2.

ckeditor4-angular 2.2.1

Fixed Issues:

  • #191: Fixed: Cannot find module ckeditor4-integrations-common error after upgrading to 2.2.0.

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.16.1.

ckeditor4-angular 2.2.0

New Features:

  • #143: Exposed namespaceLoaded event fired when CKEDITOR namespace is loaded, which can be used for its easier customization.

ckeditor4-angular 2.1.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.16.0.
  • Updated year in license headers.

ckeditor4-angular 2.0.1

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.15.1.

ckeditor4-angular 2.0.0

Breaking Changes:

ckeditor4-angular 1.3.0

Other Changes:

  • Updated default CDN CKEditor 4 dependency to 4.15.0.
  • #98: Updated repository dependencies (no changes in the actual ckeditor4-angular package).
  • #128: Improve the stability of getEditorNamespace() method.

ckeditor4-angular 1.2.2

Fixed Issues:

  • #110: Fixed: Integration throws an error when CKEditor 4 component is removed from the DOM before CKEditor 4 is loaded. Thanks to Benjamin Hugot!

ckeditor4-angular 1.2.1

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.14.1.

ckeditor4-angular 1.2.0

New Features:

ckeditor4-angular 1.1.0

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.14.0.

ckeditor4-angular 1.0.1

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.13.1.

ckeditor4-angular 1.0.0

New Features:

  • #6: Added support for classic (iframe-based) editor. Starting from this version classic editor is used by default.
  • #40: Added support for Angular 5.

Fixed Issues:

  • #42: Fixed: The elementRef related error is thrown when using Angular 5.
  • #54: Fixed: Two-way data binding does not work when the Undo plugin is not present.

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.13.0.

ckeditor4-angular 1.0.0-beta.2

Other Changes:

  • Updated the default CKEditor 4 CDN dependency to 4.12.1.

ckeditor4-angular 1.0.0-beta

Other Changes:

  • #28: Updated package dev dependencies.

ckeditor4-angular 0.1.2

Other Changes:

  • #20: Added the "Quick Start" section to README file.
  • #10: Updated the LICENSE file with all required dependencies.

ckeditor4-angular 0.1.1

Other Changes:

  • README.md file improvements.

ckeditor4-angular 0.1.0

The first beta release of CKEditor 4 WYSIWYG Editor Angular Integration.