Contribute to this guide

Update to CKEditor 5 v28.x

When updating your CKEditor 5 installation, ensure all the packages are the same version to avoid errors.

For custom builds, you may try removing the package-lock.json or yarn.lock files (if applicable) and reinstalling all packages before rebuilding the editor. For best results, make sure you use the most recent package versions.

# Update to CKEditor 5 v28.0.0

Released on June 7, 2021.

For the entire list of changes introduced in version 28.0.0, see the release notes for CKEditor 5 v28.0.0.

Below are the most important changes that require your attention when upgrading to CKEditor 5 v28.0.0.

# Imports from index files of non-DLL core packages

Starting from v26.0.0, you could use the src/index.js files present in all packages to simplify the import rules.

However, prior to v28.0.0, in some packages, the src/index.js file was exporting one object instead of multiple tokens, so the import rule looked as shown:

// Importing the default export.
import BasicStyles from '@ckeditor/ckeditor5-basic-styles/src/index';

// And destructuring plugins from the module.
const { Bold, Italic } = BasicStyles;

Starting from v28.0.0, all the packages use multiple exports so you can import the plugins directly:

import { Bold, Italic } from '@ckeditor/ckeditor5-basic-styles/src/index';

The list of affected packages: