CKEditor Ecosystem Documentation
Search
⚠️ WarningNightly documentation ahead. Switch to the stable editor documentation.
Home/CKEditor 5/API
Interface

ImageInsertConfig (image)

@ckeditor/ckeditor5-image/src/imageinsert

interface
See source

The configuration of the image insert dropdown panel view. Used by the image insert feature in the @ckeditor/ckeditor5-image package.

ClassicEditor
	.create( editorElement, {
		image: {
			insert: {
				... // settings for "insertImage" view goes here
			}
		}
	} )
	.then( ... )
	.catch( ... );

See all editor options.

Filtering

Properties

  • type : 'inline' | 'block' | undefined

    This options allows to override the image type used by the InsertImageCommand when the user inserts new images into the editor content. By default, this option is unset which means the editor will choose the optimal image type based on the context of the insertion (e.g. the current selection and availability of plugins)

    See source

    Available options are:

    • 'block' – all images inserted into the editor will be block (requires the ImageBlock plugin),
    • 'inline' – all images inserted into the editor will be inline (requires the ImageInline plugin).

  • integrations : Array.<String>

    protected

    The image insert panel view configuration contains a list of ImageInsert integrations.

    See source

    The option accepts string tokens.

    • for predefined integrations, we have two special strings: insertImageViaUrl and openCKFinder. The former adds the Insert image via URL feature, while the latter adds the built-in CKFinder integration.

    • for custom integrations, each string should be a name of the component registered in the component factory. If you have a plugin PluginX that registers pluginXButton component, then the integration token in that case should be pluginXButton.

      // Add `insertImageViaUrl`, `openCKFinder` and custom `pluginXButton` integrations.
const imageInsertConfig = {
	insert: {
		integrations: [
			'insertImageViaUrl',
			'openCKFinder',
			'pluginXButton'
		]
	}
};

    Defaults to [ 'insertImageViaUrl' ]