Contribute to this guide

guideImages in CKEditor 5 (overview)

CKEditor 5 comes with various tools to work with images. The editor allows inserting (uploading), resizing, styling, captioning and linking images. All these features work both with block, inline, and responsive images out-of-the-box.

To see the all image features in action, check out the demo below. To learn more about individual plugins (sub-features) in the image ecosystem, see the Image features section.

# Demo

Walking the capitals of Europe: Coat of arms of Warsaw Warsaw

If you enjoyed my previous articles in which we discussed wandering around Copenhagen and Vilnius, you’ll definitely love exploring Warsaw.

The panorama of Warsaw
Panorama of Warsaw downtown.

Time to put comfy sandals on!

The best time to visit the city is in July and August when it’s cool enough to not break a sweat and hot enough to enjoy summer. The city which has quite a combination of both old and modern textures is located by the river of Vistula.

Warsaw Castle Square
Castle Square is a historic square in front of the Royal Castle – the former official residence of Polish monarchs

The historic See on Google Maps Old Town, which was reconstructed after World War II, with its late 18th century characteristics, is a must-see. You can start your walk from the See on Google Maps Nowy Świat Street which will take you straight to the Old Town.

Then you can go to the See on Google Maps Powiśle area and take a walk on the newly renovated promenade on the riverfront. There are also lots of cafes, bars and restaurants where you can shake off the exhaustion of the day. On Sundays, there are many parks where you can enjoy nature or listen to pianists from around the world playing Chopin.


This demo only presents a limited set of features. Visit the full-featured editor example to see more in action.

# Base image feature

The base image feature does not support any user interface for inserting or managing images. Its sole purpose is to lay ground for other plugins (listed below) to build the target user experience. This pattern (composition of atomic features) is common for CKEditor 5 and allows the developers to build their own customized experience by implementing specific subfeatures differently.

# Image features

The @ckeditor/ckeditor5-image package contains multiple plugins that implement various image-related features. The Image plugin is at the core of the ecosystem. Available in all ready-to-use editor builds, it provides the basic support for block and inline images. There are many other features that extend the editor capabilities:

The availability of these plugins varies in different predefined editor builds but the most important ones are present in all builds as presented in the table below:

Image feature (plugin) Predefined editor build
Classic Inline Balloon Balloon block Document Superbuild
Image ImageBlock

You can add more image features to your editor using the online builder or manually by customizing your editor build.

# Image contextual toolbar

The ImageToolbar plugin available in all editor builds introduces a contextual toolbar for images. The toolbar appears when an image is selected and can be configured to contain any buttons you want. Usually, these will be image-related options such as the text alternative button, the image caption button, and image styles buttons. Shown below is an example contextual toolbar as observed in the demo above with a large set of buttons.

An extended contextual toolbar.

The image toolbar is configurable using the config.image.toolbar property. For instance, to display the caption toggle and text alternative buttons, use the following configuration:

    .create( document.querySelector( '#editor' ), {
        image: {
            toolbar: [ 'toggleImageCaption', 'imageTextAlternative' ]
    } )

Refer to the image installation guide for more details on configuring the features available in the toolbar and to the toolbar section of the Migration to v29.x guide, as important changes were introduced in that version. You can also check the editor toolbar guide.

See the common API of image-related features such as ImageStyle, ImageResize, and LinkImage to learn more about available image toolbar buttons.

# Responsive images

Support for responsive images in CKEditor 5 is brought by the CKBox management platform. The Easy Image feature can also be used without any additional configuration. Refer to the Easy Image integration guide to learn how to use the feature in your project.

# Typing around images

To type before or after an image easily, select the image, then press the Arrow key ( or ) once, depending on where you want to add content – before or after respectively. The image becomes no longer selected and whatever text you type will appear in the desired position.

You can also use the Insert paragraph handles on the bottom or top edge of the selected image to add a paragraph below or above the image, respectively.

Paragraph insertion handles.

# Contribute

The source code of the feature is available on GitHub in