Contribute to this guide

guideAPI and events

Quick recap

In the previous guide you have learned how to set and get data from the editor. You can also start using the editor’s API and events.

CKEditor 5 API allows developers to interact with the editor and its plugins to create new behaviors. Through the event system, you can tailor reactions to specific actions that are happening.

# Using the API

The API allows you to do multiple things with the editor and its content:

editor.model.change( writer => {
    // Move selection to the end of the document.
        writer.createPositionAt( editor.model.document.getRoot(), 'end' )

    // Execute the enter command.
    editor.execute( 'enter' );

    // Insert text.
    editor.model.change( writer => {
        editor.model.insertContent( writer.createText( 'The End!' ) );
    } );
} );

In the example above, you use a selection and a command, and you change the content using the editor’s model. All of this could be reverted with one undo step. This is a simple example of what the API can do.

Check more examples how to use the API or deep dive into our step-by-step tutorial.

# Using events

The editor’s instance can also be used to set up listeners for events. Every plugin in the editor publishes events that you can subscribe to and interact with. For example, the Document#change:data event is fired when the document changes in such a way that is “visible” in the editor data:

editor.model.document.on( 'change:data', () => {
    console.log( 'The data has changed!' );
} );

Events could be used to alter the behavior of the editor. Imagine a user wants to swap the Enter with the Shift + Enter, so Shift + Enter will insert a new block, while Enter will insert a <br>.

editor.editing.view.document.on( 'enter', ( evt, data ) => {

    if ( data.isSoft ) {
            editor.execute( 'enter' );


    editor.execute( 'shiftEnter' );
}, { priority: 'high' } );

You can find more information about events in the framework documentation.

What’s next

Having explored the API and events, it is time to take the next step: extend your editor’s features.