New to KendoReact? Start a free 30-day trial

Breaking Changes in 17.0.0

Updated on Nov 11, 2026

Some of the following changes can be migrated with the KendoReact codemods. For more information, see Available Codemods.

Buttons

  • The custom-content startIcon and endIcon properties of the Button, DropDownButton, and SplitButton are renamed to prefix and suffix, respectively. The SmartPasteButton inherits the same change from ButtonProps. Preserve your React content when renaming these props.
  • endIcon now accepts a font icon name (string) instead of arbitrary React content. To render a custom trailing element, use suffix; to render a trailing SVG icon, use the new endSvgIcon property.
  • The SplitButton component has been converted to a functional component. Its ref now exposes a SplitButtonHandle with only element and props; class instance members and methods are no longer available through the ref. Type refs as SplitButtonHandle instead of the former class instance type. The Buttons v17 codemod migrates SplitButton and SplitButtonClassComponent ref type references.

Map

  • The Map component has been converted to a functional component. Its ref and the target of every Map event (BeforeResetEvent, MapClickEvent, MarkerActivateEvent, MarkerClickEvent, MarkerCreatedEvent, PanEndEvent, PanEvent, ResetEvent, ShapeClickEvent, ShapeCreatedEvent, ShapeFeatureCreatedEvent, ShapeMouseEnterEvent, ShapeMouseLeaveEvent, ZoomEndEvent, and ZoomStartEvent) are now a MapHandle. Type a Map ref as MapHandle.
  • MapHandle exposes element, props, mapInstance, layers, extent, resize, viewSize, eventOffset, eventToLayer, eventToLocation, eventToView, layerToLocation, locationToLayer, locationToView, viewToLocation, and loadMarkers. The React class members (state, setState, forceUpdate, context, refs) and the internal methods (refresh, trigger, getMapOptions, instantiateCoreMap, requiresHandlers) are no longer available.
  • The element property of the Map ref is now typed as HTMLDivElement | null instead of HTMLDivElement.

Scheduler

  • SchedulerFormEditor.recurrenceButtonTextTemplate and RecurrenceButtonTextTemplateProps are deprecated. The template is ignored: the recurrence button now uses the localized Make recurring and Edit recurrence labels. Use recurrenceSummaryTemplate and RecurrenceSummaryTemplateProps to customize the summary below the button and inside the recurrence dialog. The summary template is called only when a recurrence rule exists, and its props are no longer nullable. The v17 recurrence template codemod migrates these names; review custom templates for the changed placement and invocation.
  • The Scheduler has a new eventOverview property that is enabled by default. Clicking an event, or pressing Enter on a focused event, now opens an overview popover with Edit and Delete actions instead of selecting the event only (with Enter, instead of opening the edit form). Recurring events offer occurrence and series options. Double-clicking an event still opens the edit form. Set eventOverview={false} to restore the previous behavior.
  • The Scheduler has a new quickCreate property that is enabled by default. When editable.add is enabled, clicking an empty slot, or pressing Enter on a focused slot, now opens a popover with a title input and a More options action that opens the full edit form. The quick-create popover is not available in the AgendaView. Use the new quickCreateForm property and the SchedulerQuickCreateForm component to customize it. Set quickCreate={false} to restore the previous behavior.
  • The overview and quick-create popovers open approximately 200 ms after a click so that a double click can still open the full edit form. Tests that click an event or a slot and immediately assert the popover need to wait for it.
  • Cancelling or closing a SchedulerForm with modified values now shows a DiscardChangesDialog that asks for confirmation instead of closing the form immediately.
  • Editing or removing the master event of a recurring series with custom exceptions now shows a KeepResetCustomEventsDialog. When the series is edited, resetting removes the exceptions and reports them in the deleted collection of onDataChange, while keeping them leaves them linked to the series. When the series is removed, resetting reports the exceptions in the deleted collection and keeping converts them to standalone events reported in the updated collection. Review onDataChange handlers that do not expect these additional items.
  • In DayView, WeekView, and WorkWeekView, timed events that span multiple days now appear in the all-day row with start and end times. Review custom viewItem renderers, styling, or DOM queries that assume these events render in the timed grid. For the updated markup and classes, see Scheduler rendering changes.

Sortable

  • The Sortable component has been converted to a functional component. Sortable is no longer a type. When using a ref, type it as SortableHandle instead of the class instance type Sortable.
  • SortableHandle exposes only element and props. The React class members (state, setState, forceUpdate) and the internal methods of the class component are no longer available through the ref or the event target.
  • SortableOnDragStartEvent, SortableOnDragOverEvent, SortableOnDragEndEvent, and SortableOnNavigateEvent have been converted from classes to interfaces. They can no longer be created with new, checked with instanceof, or extended by a class. Their target property is now a SortableHandle.

TreeView

  • Custom components passed through the item property no longer render inside a .k-treeview-leaf-text wrapper. Review custom item styling and DOM queries that depend on this wrapper. Default item rendering is unchanged. For details, see the TreeView rendering changes.
In this article
ButtonsMapSchedulerSortableTreeView
Not finding the help you need?
Contact Support