Error codes - CKEditor 5 Documentation

`attachtoform-missing-elementapi-interface`

The editor passed to attachToForm() must implement the ElementApi interface.

`attribute-element-get-elements-with-same-id-no-id`

Cannot get elements with the same id for an attribute element without id.

`attribute-operation-attribute-exists`

The attribute with given key already exists for the given node.

Parameters

node : Node
key : String

`attribute-operation-range-not-flat`

The range to change is not flat.

`attribute-operation-wrong-old-value`

Changed node has different attribute value than operation's old attribute value.

Parameters

item : Item
key : String
value : *

`cannot-change-view-tree`

Thrown when there is an attempt to make changes to the view tree when it is in incorrect state. This may cause some unexpected behaviour and inconsistency between the DOM and the view. This may be caused by:

calling change or render during rendering process,
calling change or render inside of post-fixer function.

`ckeditor-version-collision`

This error is thrown when the CKEDITOR_VERSION global is being set more than once. This happens when in two scenarios described above.

Some packages were duplicated

CKEditor 5 was built from source packages which were duplicated during installation via npm. Normally, npm deduplicates all packages so e.g. @ckeditor/ckeditor5-core is installed only once in node_modules/. However, subsequent npm install calls or conflicting version dependencies may cause npm to install some packages more than once. Furthermore, npm in version 5+ is also known for randomly failing to deduplicate packages.

We recommend checking if any of the below steps helps:

rm -rf node_modules && npm install to make sure you have a clean node_modules/ – this step is known to help in majority of cases,
check whether all CKEditor 5 packages are up to date and reinstall them if you changed anything (rm -rf node_modules && npm install),
downgrade npm to version 4 if you use a newer version.

If all packages are correct and compatible with each other the above steps are known to help. If not, you may try to check with npm ls how many times @ckeditor/ckeditor5-core is installed. If more than once, verify which package causes that.

Two+ builds are loaded

If you use CKEditor 5 builds, you might have loaded two (or more) ckeditor.js files in one web page – check your web page for duplicated <script> elements or make sure your page builder/bundler includes CKEditor only once.

Parameters

collidingVersion : String: The version of the build which has already been (incorrectly) loaded.
version : String: The version of the build which is supposed to be loaded.

`collection-add-invalid-id`

This item's id should be a string.

`collection-add-item-already-exists`

This item already exists in the collection.

`collection-add-item-bad-index`

The index number has invalid value.

`collection-bind-to-rebind`

The collection cannot be bound more than once.

`collection-get-invalid-arg`

Index or id must be given.

`collection-remove-404`

Item not found.

`commandcollection-command-not-found`

Command does not exist.

Parameters

commandName : String: Name of the command.

`componentfactory-item-exists`

The item already exists in the component factory.

Parameters

name : String: The name of the component.

`componentfactory-item-missing`

The required component is not registered in the component factory. Please make sure the provided name is correct and the component has been correctly added to the factory.

Parameters

name : String: The name of the missing component.

`contextualballoon-add-view-exist`

Trying to add configuration of the same view more than once.

`contextualballoon-remove-view-not-exist`

Trying to remove configuration of the view not defined in the stack.

`conversion-attribute-to-attribute-on-text`

This error occurs when a text node's attribute is to be downcasted by Attribute to Attribute converter. In most cases it is caused by converters misconfiguration when only "generic" converter is defined:

editor.conversion.for( 'downcast' ).add( downcastAttributeToAttribute( {
    model: 'attribute-name',
    view: 'attribute-name'
} ) );

and given attribute is used on text node, for example:

model.change( writer => {
    writer.insertText( 'Foo', { 'attribute-name': 'bar' }, parent, 0 );
} );

In such cases, to convert the same attribute for both Element and Text nodes, text specific Attribute to Element converter with higher priority must also be defined:

conversion.for( 'downcast' ).add( downcastAttributeToElement( {
    model: {
        key: 'attribute-name',
        name: '$text'
    },
    view: ( value, writer ) => {
        return writer.createAttributeElement( 'span', { 'attribute-name': value } );
    },
    converterPriority: 'high'
} ) );

`conversion-for-unknown-group`

Trying to add a converter to an unknown dispatchers group.

`conversion-register-group-exists`

Trying to register a group name that was already registered.

`datacontroller-init-document-not-empty`

Cannot set initial data to not empty Document. Initial data should be set once, during Editor initialization, when the version is equal 0.

`detach-operation-on-document-node`

Cannot detach document node.

`document-applyOperation-wrong-version`

Only operations with matching versions can be applied.

Parameters

operation : Operation

`document-selection-gravity-wrong-restore`

Restoring gravity for an unknown UID is not possible. Make sure you are using a correct UID obtained from the overrideSelectionGravity to restore.

Parameters

uid : String: The unique identifier returned by overrideGravity.

`document-selection-wrong-position`

Range from document selection starts or ends at incorrect position.

Parameters

range : Range

`editor-missing-sourceelement`

Cannot update the source element of a detached editor.

The updateSourceElement() method cannot be called if you did not pass an element to Editor.create().

`filerepository-no-upload-adapter`

You need to enable an upload adapter in order to be able to upload files.

This warning shows up when FileRepository is being used without definining an upload adapter.

If you see this warning when using one of the CKEditor 5 Builds it means that you did not configure any of the upload adapters available by default in those builds.

See the comprehensive "Image upload overview" to learn which upload adapters are available in the builds and how to configure them.

If you see this warning when using a custom build there is a chance that you enabled a feature like ImageUpload, or ImageUploadUI but you did not enable any upload adapter. You can choose one of the existing upload adapters listed in the "Image upload overview".

You can also implement your own image upload adapter.

`insert-operation-position-invalid`

Insertion position is invalid.

`liveposition-root-not-rootelement`

LivePosition's root has to be an instance of RootElement.

`marker-destroyed`

Cannot use a destroyed marker instance.

`merge-operation-how-many-invalid`

Merge operation specifies wrong number of nodes to move.

`merge-operation-source-position-invalid`

Merge source position is invalid.

`merge-operation-target-position-invalid`

Merge target position is invalid.

`model-createPositionAt-offset-required`

Model#createPositionAt() requires the offset to be specified when the first parameter is a model item.

`model-document-createRoot-name-exists`

A root with the specified name already exists.

Parameters

doc : Document
name : String

`model-node-not-found-in-parent`

The node's parent does not contain this node.

This error may be thrown from corrupted trees.

`model-nodelist-offset-out-of-bounds`

Given offset cannot be found in the node list.

Parameters

offset : Number
nodeList : NodeList: Stringified node list.

`model-position-after-root`

You can not make a position after a root element.

Parameters

root : Item

`model-position-before-root`

You can not make a position before a root element.

Parameters

root : Item

`model-position-fromjson-no-root`

Cannot create position for document. Root with specified name does not exist.

Parameters

rootName : String

`model-position-parent-incorrect`

Position parent have to be a model element or model document fragment.

`model-position-path-incorrect`

Position path must be an array with at least one item.

Parameters

path

`model-position-root-invalid`

Position root is invalid.

Positions can only be anchored in elements or document fragments.

`model-selection-range-intersects`

Trying to add a range that intersects with another range in the selection.

Parameters

addedRange : Range: Range that was added to the selection.
intersectingRange : Range: Range in the selection that intersects with addedRange.

`model-selection-set-ranges-not-range`

Selection range set to an object that is not an instance of Range.

Only Range instances can be used to set a selection. Common mistakes leading to this error are:

using DOM Range object,
incorrect CKEditor 5 installation with multiple ckeditor5-engine packages having different versions.

`model-selection-setFocus-no-ranges`

Cannot set selection focus if there are no ranges in selection.

`model-selection-setTo-not-selectable`

Cannot set selection to given place.

`model-selection-setTo-required-second-parameter`

selection.setTo requires the second parameter when the first parameter is a node.

`model-textproxy-wrong-length`

Given length value is incorrect.

`model-textproxy-wrong-offsetintext`

Given offsetInText value is incorrect.

`model-tree-walker-no-start-position`

Neither boundaries nor starting position of a TreeWalker have been defined.

`move-operation-node-into-itself`

Trying to move a range of nodes into one of nodes from that range.

`move-operation-nodes-do-not-exist`

The nodes which should be moved do not exist.

`move-operation-position-invalid`

Source position or target position is invalid.

`move-operation-range-into-itself`

Trying to move a range of nodes into the middle of that range.

`nodelist-index-out-of-bounds`

Given index cannot be found in the node list.

`nodelist-insertNodes-not-node`

Trying to insert an object which is not a Node instance.

`observable-bind-duplicate-properties`

Properties must be unique.

`observable-bind-no-callback`

Binding multiple observables only possible with callback.

`observable-bind-rebind`

Cannot bind the same property more that once.

`observable-bind-to-extra-callback`

Cannot bind multiple properties and use a callback in one binding.

`observable-bind-to-many-not-one-binding`

Binding one attribute to many observables only possible with one attribute.

`observable-bind-to-parse-error`

Invalid argument syntax in to().

`observable-bind-to-properties-length`

The number of properties must match.

`observable-bind-wrong-properties`

All properties must be strings.

`observable-set-cannot-override`

Cannot override an existing property.

This error is thrown when trying to set an property with a name of an already existing property. For example:

let observable = new Model();
observable.property = 1;
observable.set( 'property', 2 );            // throws

observable.set( 'property', 1 );
observable.set( 'property', 2 );            // ok, because this is an existing property.

`observable-unbind-wrong-properties`

Properties must be strings.

`observablemixin-cannot-decorate-undefined`

Cannot decorate an undefined method.

Parameters

object : Object: The object which method should be decorated.
methodName : String: Name of the method which does not exist.

`operation-utils-move-range-not-flat`

Trying to move a range which starts and ends in different element.

`operation-utils-remove-range-not-flat`

Trying to remove a range which starts and ends in different element.

`pendingactions-add-invalid-message`

The message must be a string.

`plugincollection-load`

It was not possible to load the plugin.

This is a generic error logged to the console when a JavaSript error is thrown during the initialization of one of the plugins.

If you correctly handled the promise returned by the editor's create() method (like shown below) you will find the original error logged to the console, too:

ClassicEditor.create( document.getElementById( 'editor' ) )
    .then( editor => {
        // ...
    } )
    .catch( error => {
        console.error( error );
    } );

Parameters

plugin : String: The name of the plugin that could not be loaded.

`plugincollection-plugin-name-conflict`

Two plugins with the same pluginName were loaded. This will lead to runtime conflicts between these plugins.

In practice, this warning usually means that new plugins were added to an existing CKEditor 5 build. Plugins should always be added to a source version of the editor (@ckeditor/ckeditor5-editor-*), not to an editor imported from one of the @ckeditor/ckeditor5-build-* packages.

Check your import paths and the list of plugins passed to Editor.create() or specified in Editor.builtinPlugins.

The second option is that your node_modules/ directory contains duplicated versions of the same CKEditor 5 packages. Normally, on clean installations, npm deduplicates packages in node_modules/, so it may be enough to call rm -rf node_modules && npm i. However, if you installed conflicting versions of packages, their dependencies may need to be installed in more than one version which may lead to this warning.

Technically speaking, this error occurs because after adding a plugin to an existing editor build dependencies of this plugin are being duplicated. They are already built into that editor build and now get added for the second time as dependencies of the plugin you are installing.

Parameters

pluginName : String: The duplicated plugin name.
plugin1 : function: The first plugin constructor.
plugin2 : function: The second plugin constructor.

`plugincollection-plugin-not-found`

Some plugins are not available and could not be loaded.

Plugin classes (constructors) need to be provided to the editor before they can be loaded by name. This is usually done in CKEditor 5 builds by setting the builtinPlugins property.

If you see this warning when using one of the CKEditor 5 Builds, it means that you try to enable a plugin which was not included in that build. This may be due to a typo in the plugin name or simply because that plugin is not a part of this build. In the latter scenario, read more about custom builds.

If you see this warning when using one of the editor creators directly (not a build), then it means that you tried loading plugins by name. However, unlike CKEditor 4, CKEditor 5 does not implement a "plugin loader". This means that CKEditor 5 does not know where to load the plugin modules from. Therefore, you need to provide each plugin through reference (as a constructor function). Check out the examples in "Building from source".

Parameters

plugins : Array.<String>: The name of the plugins which could not be loaded.

`plugincollection-required`

Cannot load a plugin because one of its dependencies is listed in the removePlugins option.

Parameters

plugin : function: The required plugin.
requiredBy : function: The parent plugin.

`range-create-from-ranges-empty-array`

At least one range has to be passed to Range.\_createFromRanges().

`rect-source-not-in-dom`

The Rect class depends on getBoundingClientRect and getClientRects DOM methods. If the source of a rect in an HTML element or a DOM range but it does not belong to any rendered DOM tree, these methods will fail to obtain the geometry and the rect instance makes little sense to the features using it.

To get rid of this warning make sure the source passed to the constructor is a descendant of window.document.body.

Parameters

source : String: The source of the Rect instance.

`rename-operation-wrong-name`

Element to change has different name than operation's old name.

`rename-operation-wrong-position`

Given position is invalid or node after it is not instance of Element.

`renderer-unknown-type`

Unknown type passed to Renderer.markToSync.

`rootattribute-operation-attribute-exists`

The attribute with given key already exists for the given node.

Parameters

root : RootElement
key : String

`rootattribute-operation-not-a-root`

The element to change is not a root element.

Parameters

root : RootElement
key : String
value : *

`rootattribute-operation-wrong-old-value`

The attribute which should be removed does not exists for the given node.

Parameters

root : RootElement
key : String
value : *

`rootattributeoperation-fromjson-no-root`

Cannot create RootAttributeOperation for document. Root with specified name does not exist.

Parameters

rootName : String

`schema-check-merge-no-element-after`

The node after the merge position must be an element.

`schema-check-merge-no-element-before`

The node before the merge position must be an element.

`selectionchange-infinite-loop`

Selection change observer detected an infinite rendering loop. Most probably you try to put the selection in the position which is not allowed by the browser and browser fixes it automatically what causes selectionchange event on which a loopback through a model tries to re-render the wrong selection and again.

`split-operation-graveyard-position-invalid`

Graveyard position invalid.

`split-operation-how-many-invalid`

Split operation specifies wrong number of nodes to move.

`split-operation-position-invalid`

Split position is invalid.

`split-operation-split-in-root`

Cannot split root element.

`template-extend-render`

Extending a template after rendering may not work as expected. To make sure the extending works for an element, make sure it happens before render is called.

`toolbarview-item-unavailable`

There was a problem processing the configuration of the toolbar. The item with the given name does not exist so it was omitted when rendering the toolbar.

This warning usually shows up when the Plugin which is supposed to provide a toolbar item has not been loaded or there is a typo in the configuration.

Make sure the plugin responsible for this toolbar item is loaded and the toolbar configuration is correct, e.g. Bold is loaded for the 'bold' toolbar item.

You can use the following snippet to retrieve all available toolbar items:

Array.from( editor.ui.componentFactory.names() );

Parameters

name : String: The name of the component.

`ui-template-extend-children-mismatch`

The number of children in extended definition does not match.

`ui-template-revert-not-applied`

Attempting to revert a template which has not been applied yet.

`ui-template-wrong-syntax`

Node definition cannot have the "tag" and "text" properties at the same time. Node definition must have either "tag" or "text" when rendering a new Node.

`ui-view-render-rendered`

This View has already been rendered.

`ui-viewcollection-delegate-wrong-events`

All event names must be strings.

`view-conversion-dispatcher-incorrect-result`

Incorrect conversion result was dropped.

Model range should be a conversion result.

`view-createPositionAt-offset-required`

View#createPositionAt() requires the offset to be specified when the first parameter is a view item.

`view-editableelement-document-already-set`

View document is already set. It can only be set once.

`view-emptyelement-cannot-add`

Cannot add children to EmptyElement.

`view-focus-no-selection`

Before focusing view document, selection should be placed inside one of the view's editables. Normally its selection will be converted from model document (which have default selection), but when using view document on its own, we need to manually place selection before focusing it.

`view-node-not-found-in-parent`

The node's parent does not contain this node. It means that the document tree is corrupted.

`view-position-after-root`

You can not make a position after a root.

Parameters

root : Node

`view-position-before-root`

You cannot make a position before a root.

Parameters

root : Node

`view-renderer-filler-was-lost`

The inline filler node was lost. Most likely, something overwrote the filler text node in the DOM.

`view-selection-add-range-not-range`

Selection range set to an object that is not an instance of Range.

`view-selection-range-intersects`

Trying to add a range that intersects with another range from selection.

Parameters

addedRange : Range: Range that was added to the selection.
intersectingRange : Range: Range from selection that intersects with addedRange.

consumables.add( { attributes: [ 'class', 'style' ] } );

While each class and style should be registered separately:

consumables.add( { classes: 'some-class', styles: 'font-weight' } );

Toolbar with the given id was already added.

Parameters

toolbarId: Toolbar id.