CKEditor Ecosystem Documentation
Search
Contribute to this guide
Home/CKEditor 5/Updating

Updating CKEditor 5

This guide covers the topic of keeping your CKEditor 5 copy up-to-date. If you would like to upgrade from CKEditor 4 to CKEditor 5, please see the Migrating from CKEditor 4 guide instead.

# Updating the editor

CKEditor 5 is delivered in several ways and the most flexible and popular one is by using npm packages. The updating process is simple and narrows down to, depending on the installation method, downloading a new package or updating package versions in the package.json file.

Before proceeding with an update, it is highly recommended to read the changelog for the latest version to learn about all changes introduced in the release. You should especially pay attention to any possible breaking changes. This step is crucial if you develop your own custom features and modify the editor, as sometimes, changes in our code might affect these custom solutions.

To help you with a smooth update, we have prepared migration guides that describe adjustments that need to be done before moving to the production environment. You can find them in the sidebar located on the left side of the page.

Always remember to test your editor before deploying the changes into the production environment. This will help ensure that the update will not have a negative impact on your application and user experience.

You can simply visit our CKEditor 5 download page or Builder and get the latest editor version from there. However, if you created your own customized editor, the process can be described in a few steps:

  1. Read the changelog.
  2. Update your packages.
  3. Read the migration guide.
  4. Reinstall packages and rebuild the editor.
  5. Test your editor.

Below you will find an example that will guide you through the updating process and give you an idea on how it should be done.

# Example

Imagine that you use the editor in and older version and you want to update it to the current 44.1.0 version.

The first step is to identify changes introduced since the old version, so you navigate update guides (found on the left) to identify any possible breaking changes between the old version and the current. These guides will navigate you through any necessary code changes.

It is recommended to update regularly. Sometimes, however, it could happen that you skip a few releases and need to update to a non-adjacent version. In such a case, remember to verify the changelog and migration guides for all missing versions, not only the one you are updating to.

When you already know what has changed and which parts of your custom code need to be adjusted, it is time to make the update.

This can be done by updating the package.json file with the latest editor version (currently 44.1.0) or using some automated tool (like npm-check-updates):

    "dependencies": {
        "@ckeditor/ckeditor5-adapter-ckfinder": "^44.1.0",
        "@ckeditor/ckeditor5-autoformat": "^44.1.0",
        "@ckeditor/ckeditor5-basic-styles": "^44.1.0",
        "@ckeditor/ckeditor5-block-quote": "^44.1.0",
        "@ckeditor/ckeditor5-ckfinder": "^44.1.0",
        "@ckeditor/ckeditor5-cloud-services": "^44.1.0",
        "@ckeditor/ckeditor5-easy-image": "^44.1.0",
        "@ckeditor/ckeditor5-editor-classic": "^44.1.0",
        "@ckeditor/ckeditor5-essentials": "^44.1.0",
        "@ckeditor/ckeditor5-heading": "^44.1.0",
        "@ckeditor/ckeditor5-image": "^44.1.0",
        "@ckeditor/ckeditor5-indent": "^44.1.0",
        "@ckeditor/ckeditor5-link": "^44.1.0",
        "@ckeditor/ckeditor5-list": "^44.1.0",
        "@ckeditor/ckeditor5-media-embed": "^44.1.0",
        "@ckeditor/ckeditor5-paragraph": "^44.1.0",
        "@ckeditor/ckeditor5-paste-from-office": "^44.1.0",
        "@ckeditor/ckeditor5-table": "^44.1.0",
        "@ckeditor/ckeditor5-typing": "^44.1.0"
    }

Finally, you reinstall the packages and rebuild the editor. Note that sometimes it might be required to remove the package-lock.json or yarn.lock files.

rm -rf node_modules && yarn install && yarn run build

This is it! Your editor is updated and now you can focus on adjusting your custom solutions (if needed). If you use real-time collaboration, you should check the next section.

# Real-time collaboration

While using real-time collaboration it is important to remember about preparing existing documents for the updated editor. Basically, it is not possible to join the document that was created with a CKEditor 5 version different than the one used by the client. For example, imagine a situation when the document has been initialized with the editor version 30.0.0 and after the update, a user connects to this document with the editor version 31.0.0. In such a case, an error about an incompatible engine version will be thrown.

A collaboration session will be removed 24 hours after the last user disconnects. You can also manually flush any existing collaboration sessions using the Cloud Services REST API. After the collaboration session removal, users will be able to connect to the documents using a new editor.

If you are using Collaboration Server On-premises, it is recommended to keep it updated at all times, just like CKEditor 5. Our collaboration features are strongly linked with Cloud Services, so it is important to keep compatibility between On-premises and CKEditor 5.