@ckeditor/ckeditor5-list is a plugin for CKEditor 5 that provides advanced list editing capabilities. It allows users to create and manage ordered and unordered lists, as well as nested lists, with ease.

What are @ckeditor/ckeditor5-list's main functionalities?

Ordered List

This feature allows users to create ordered (numbered) lists in the editor. The code sample demonstrates how to initialize CKEditor with the List plugin and add the 'numberedList' button to the toolbar.

ClassicEditor.create(document.querySelector('#editor'), { plugins: [ List ], toolbar: [ 'numberedList' ] });

Unordered List

This feature enables users to create unordered (bulleted) lists. The code sample shows how to set up CKEditor with the List plugin and include the 'bulletedList' button in the toolbar.

ClassicEditor.create(document.querySelector('#editor'), { plugins: [ List ], toolbar: [ 'bulletedList' ] });

Nested Lists

This feature allows users to create nested lists, both ordered and unordered. The code sample demonstrates initializing CKEditor with the List plugin and adding both 'numberedList' and 'bulletedList' buttons to the toolbar.

ClassicEditor.create(document.querySelector('#editor'), { plugins: [ List ], toolbar: [ 'numberedList', 'bulletedList' ] });

Other packages similar to @ckeditor/ckeditor5-list

CKEditor 5 list feature

This package implements bulleted, numbered, and to-do list features for CKEditor 5.

Installation

This plugin is part of the ckeditor5 package. Install the whole package to use it.

npm install ckeditor5

Create free account

If you want to check full CKEditor 5 capabilities, sign up for a free non-commitment 14-day trial.

Demo

Check out the demos for ordered and unordered lists as well as to-do list in the CKEditor 5 documentation.

Documentation

See the @ckeditor/ckeditor5-list package page in CKEditor 5 documentation.

License

Licensed under a dual-license model, this software is available under:

the GNU General Public License Version 2 or later,
or commercial license terms from CKSource Holding sp. z o.o.

For more information, see: https://ckeditor.com/legal/ckeditor-licensing-options.

44.3.0 (March 5, 2025)

We are happy to announce the release of CKEditor 5 v44.3.0.

Release Highlights

This release brings a couple of minor improvements and bug fixes:

Link Decorators: We fixed the behavior of the multiple manual link decorators that set the rel attribute. The fix happened so deep in the engine that we improved the overall performance of the editor slightly as well.
Added a new EmptyBlock plugin: From now on, new plugin prevents adding   to the output data of blocks, works similarly to the fillEmptyBlocks configuration in CKEditor 4.
Support for the <hr> element in the General HTML Support plugin enhanced: attributes of the <hr> element are now properly preserved if configuration allows it.
Emoji: We enhanced emoji support for better compatibility with users' older devices.

For more details, see the changelog below.

MINOR BREAKING CHANGES ℹ️

engine: The ViewConsumable.consumablesFromElement() is removed and replaced with the view.Element#_getConsumables() internal method. You should use ViewConsumable.createFrom() to create consumables if needed.
engine: The ViewElementConsumables now accepts and outputs only normalized data. The ViewConsumable still accepts normalized or non-normalized input.
engine: The Matcher#match() and Matcher#matchAll() output is now normalized. The MatchResult#match now contains normalized data compatible with changes in the ViewConsumable.

Features

engine: Export the SchemaContext class from package. Closes https://github.com/ckeditor/ckeditor5/issues/18003. (commit)
html-support: Added support for the <hr> element. Closes #12973. (commit)
html-support: Add the EmptyBlock plugin that prevents adding   to output data. (commit)

Bug fixes

collaboration-core: User initials will now be generated based on the words that start with letters, ensuring that only valid alphabetic characters are used in the initials.
comments: Annotations will no longer be lost during real-time collaboration when a user removes and immediately reverts (undo) content containing comment markers.
comments: The editor will no longer crash when one user removes content containing a comment that another user is editing.
engine: The link [rel] attribute will now allow mixing manual link decorators for the same attribute, as it will be now handled as a token list. Closes #13985, Closes #6436. (commit)
mention: Mention should not be wrapped with an additional <span> when GHS is enabled. Closes #15329. (commit)
ui: Fixed an issue where the first selected color was applied instead of the second selected color when using the font color picker for the first time after loading the page. Closes #17069. (commit)
typing: Removing a nested editable does not remove an entire widget when the selection is placed at the beginning of that element. (commit)

Other changes

clipboard: Export the viewToPlainText() function. Closes #17950. (commit)
collaboration-core: Introduced a new configuration option: config.users.getInitialsCallback. It allows providing a custom callback function for user initials generation.
emoji: Improved emoji support by expanding the range of versions compatible with users' devices. Closes #18014. (commit)
emoji: Icons representing categories in the grid come from the same Unicode version to avoid rendering the non-supported ones. (commit)
emoji: Introduced the emoji.useCustomFont option to disable the filtering mechanism. Closes #18029. (commit)
engine: The whitespaces around a block filler ( ) are ignored while loading editor data. (commit)

Released packages

Check out the Versioning policy guide for more information.

<details> <summary>Released packages (summary)</summary>

Minor releases (contain minor breaking changes):

@ckeditor/ckeditor5-engine: v44.2.1 => v44.3.0

Releases containing new features:

@ckeditor/ckeditor5-html-support: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-list: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-table: v44.2.1 => v44.3.0

Other releases:

@ckeditor/ckeditor5-adapter-ckfinder: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-ai: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-alignment: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-autoformat: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-autosave: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-basic-styles: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-block-quote: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-bookmark: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-build-balloon: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-build-balloon-block: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-build-classic: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-build-decoupled-document: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-build-inline: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-build-multi-root: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-case-change: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-ckbox: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-ckfinder: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-clipboard: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-cloud-services: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-code-block: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-collaboration-core: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-comments: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-core: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-document-outline: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-easy-image: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-editor-balloon: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-editor-classic: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-editor-decoupled: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-editor-inline: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-editor-multi-root: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-emoji: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-enter: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-essentials: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-export-pdf: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-export-word: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-find-and-replace: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-font: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-format-painter: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-heading: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-highlight: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-horizontal-line: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-html-embed: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-image: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-import-word: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-indent: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-language: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-link: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-list-multi-level: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-markdown-gfm: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-media-embed: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-mention: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-merge-fields: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-minimap: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-operations-compressor: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-page-break: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-pagination: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-paragraph: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-paste-from-office: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-paste-from-office-enhanced: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-real-time-collaboration: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-remove-format: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-restricted-editing: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-revision-history: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-select-all: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-show-blocks: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-slash-command: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-source-editing: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-source-editing-enhanced: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-special-characters: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-style: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-template: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-theme-lark: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-track-changes: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-typing: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-ui: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-undo: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-upload: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-uploadcare: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-utils: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-watchdog: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-widget: v44.2.1 => v44.3.0
@ckeditor/ckeditor5-word-count: v44.2.1 => v44.3.0
ckeditor5-collaboration: v44.2.1 => v44.3.0
ckeditor5-premium-features: v44.2.1 => v44.3.0

</details>

Keywords

FAQs

What is @ckeditor/ckeditor5-list?

Is @ckeditor/ckeditor5-list popular?

Is @ckeditor/ckeditor5-list well maintained?

Package last updated on 05 Mar 2025

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

@ckeditor/ckeditor5-list