CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Interface

TrackChangesConfig (track-changes)

@ckeditor/ckeditor5-track-changes/src/trackchanges

interface

The configuration of the track changes feature.

Example:

ClassicEditor
			.create( {
				// Track changes feature configuration.
				trackChanges: {
					// Do not allow users to comment suggestions (default is `false`).
					disableComments: true,
					// Do not track styling and formatting changes (default is `default`).
					trackFormatChanges: 'never',
				    // Merges suggestion changes inside a block. (default is `true`).
					mergeNestedSuggestions: true
				}
			} )
			.then( ... )
			.catch( ... );

See all editor options.

Filtering

Properties

  • SuggestionThreadView : default | undefined

    A view class to be used to create suggestion thread views.

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

  • disableComments : boolean

    A property that specifies if the comments for suggestions are enabled or disabled. When the option is set to true, the comment thread UI for suggestions will be hidden and commenting suggestions will be disabled.

    Suggestion thread views will be marked with the additional ck-suggestion--disabled-comments class when the suggestion comments are disabled.

  • mergeNestedSuggestions : boolean

    Specifies whether suggestions on an object (e.g. image, table) should be automatically merged with suggestions inside the object (e.g. image caption, table cell).

    For example, when set to true, creating a table and writing some text inside the table will result in one suggestion. When set to false, it will be two separate suggestions, one for the inserted table and one for the inserted text.

    Keep in mind that only suggestions from the same author and of the same type are merged this way.

  • trackFormatChanges : 'default' | 'always' | 'never'

    A property that specifies whether format changes should be tracked.

    Format changes are all changes other than insertions and deletions, including: styling, structure, widgets properties, etc.

    Possible values are:

    • 'always' - all changes are going to be tracked independently (without merging).
    • 'default' - format changes made inside your own insertion suggestion will be merged with it.
    • 'never' - format changes will not be tracked.

    Defaults to 'default'.