CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Interface

CommentsConfig (comments)

@ckeditor/ckeditor5-comments/src/comments

interface

The configuration of the comments feature.

ClassicEditor
	.create( {
		comments: ... // Comments feature configuration.
	} )
	.then( ... )
	.catch( ... );

See all editor options.

Filtering

Properties

  • CommentThreadView : BaseCommentThreadView

    A view class to be used to create comment thread views (used as annotations - in sidebar balloons or in inline annotations).

    CommentThreadView is used by default when this property is not set.

  • CommentView : BaseCommentView

    A view class to be used to create comment views.

    CommentView is used by default when this property is not set.

  • editorConfig : EditorConfig

    Optional configuration for the comments editor.

    By using this property, you can customize the editor instance used in the comments reply field (e.g. by adding plugins or changing features configuration).

  • maxCommentCharsWhenCollapsed : Number

    The maximum number of characters displayed in a comment when the thread view is collapsed. Longer comments will be trimmed.

    Defaults to 140.

  • maxThreadTotalWeight : Number

    The maximum total weight of a thread before the thread becomes collapsed when it is not active:

    • Thread weight is a sum of the weight of its comments.
    • Comment weight is equal to the comment length.
    • The minimal comment weight is 200.

    Defaults to 500.

  • whenCollapsed : Number

    The total number of comments shown when the thread view is collapsed.

    The comments are displayed in the following way:

    • The first comment is displayed.
    • Some comments may be hidden (collapsed).
    • An appropriate number of the most recent comments is displayed.

    For example, when this parameter is set to 3, when collapsed, the thread view will display the first comment and two most recent comments.

    Defaults to 2.