Migrating the Sortable from v1.x to v2.x

Updated on Mar 20, 2026

Environment

Product

Progress® Kendo UI® for Angular Sortable

Description

The Sortable v2.0.0 was released in November 2018 and introduced major changes in the behavior of the component. How do I migrate from v1.x to v2.x?

Solution

The following table lists the key differences between v1.x and v2.x:

Sortable v1.x	Sortable v2.x and later
The SortableComponent handles all operations internally and changes [data] on the fly.	The SortableComponent does not handle operations and no longer automatically updates the [data] array. Subscribe to the Sortable events and call its API methods to add, move, or remove items.
The SortableComponent emits events continuously in a similar way in which the native drag events are emitted by the browser.	The SortableComponent emits a single drag event each time an item is dragged over another item.
N/A	You can prevent the default behavior of each event by calling the preventDefault method of the event argument.

Because the Sortable no longer automatically updates the [data] array, use the kendoSortableBinding directive. The directive handles reordering, adding, and removing items, and reduces boilerplate code.

For more details on data binding, refer to the Data Binding article.