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
startIconandendIconproperties of theButton,DropDownButton, andSplitButtonare renamed toprefixandsuffix, respectively. TheSmartPasteButtoninherits the same change fromButtonProps. Preserve your React content when renaming these props. endIconnow accepts a font icon name (string) instead of arbitrary React content. To render a custom trailing element, usesuffix; to render a trailing SVG icon, use the newendSvgIconproperty.- The
SplitButtoncomponent has been converted to a functional component. Itsrefnow exposes aSplitButtonHandlewith onlyelementandprops; class instance members and methods are no longer available through theref. Type refs asSplitButtonHandleinstead of the former class instance type. The Buttons v17 codemod migratesSplitButtonandSplitButtonClassComponentref type references.
Map
- The
Mapcomponent has been converted to a functional component. Itsrefand thetargetof every Map event (BeforeResetEvent,MapClickEvent,MarkerActivateEvent,MarkerClickEvent,MarkerCreatedEvent,PanEndEvent,PanEvent,ResetEvent,ShapeClickEvent,ShapeCreatedEvent,ShapeFeatureCreatedEvent,ShapeMouseEnterEvent,ShapeMouseLeaveEvent,ZoomEndEvent, andZoomStartEvent) are now aMapHandle. Type a MaprefasMapHandle. MapHandleexposeselement,props,mapInstance,layers,extent,resize,viewSize,eventOffset,eventToLayer,eventToLocation,eventToView,layerToLocation,locationToLayer,locationToView,viewToLocation, andloadMarkers. The React class members (state,setState,forceUpdate,context,refs) and the internal methods (refresh,trigger,getMapOptions,instantiateCoreMap,requiresHandlers) are no longer available.- The
elementproperty of the Maprefis now typed asHTMLDivElement | nullinstead ofHTMLDivElement.
Scheduler
SchedulerFormEditor.recurrenceButtonTextTemplateandRecurrenceButtonTextTemplatePropsare deprecated. The template is ignored: the recurrence button now uses the localized Make recurring and Edit recurrence labels. UserecurrenceSummaryTemplateandRecurrenceSummaryTemplatePropsto 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
Schedulerhas a neweventOverviewproperty that is enabled by default. Clicking an event, or pressingEnteron a focused event, now opens an overview popover with Edit and Delete actions instead of selecting the event only (withEnter, instead of opening the edit form). Recurring events offer occurrence and series options. Double-clicking an event still opens the edit form. SeteventOverview={false}to restore the previous behavior. - The
Schedulerhas a newquickCreateproperty that is enabled by default. Wheneditable.addis enabled, clicking an empty slot, or pressingEnteron 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 theAgendaView. Use the newquickCreateFormproperty and theSchedulerQuickCreateFormcomponent to customize it. SetquickCreate={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
SchedulerFormwith modified values now shows aDiscardChangesDialogthat 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 thedeletedcollection ofonDataChange, while keeping them leaves them linked to the series. When the series is removed, resetting reports the exceptions in thedeletedcollection and keeping converts them to standalone events reported in theupdatedcollection. ReviewonDataChangehandlers that do not expect these additional items. - In
DayView,WeekView, andWorkWeekView, timed events that span multiple days now appear in the all-day row with start and end times. Review customviewItemrenderers, 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
Sortablecomponent has been converted to a functional component.Sortableis no longer a type. When using aref, type it asSortableHandleinstead of the class instance typeSortable. SortableHandleexposes onlyelementandprops. The React class members (state,setState,forceUpdate) and the internal methods of the class component are no longer available through therefor the eventtarget.SortableOnDragStartEvent,SortableOnDragOverEvent,SortableOnDragEndEvent, andSortableOnNavigateEventhave been converted from classes to interfaces. They can no longer be created withnew, checked withinstanceof, or extended by a class. Theirtargetproperty is now aSortableHandle.
TreeView
- Custom components passed through the
itemproperty no longer render inside a.k-treeview-leaf-textwrapper. Review custom item styling and DOM queries that depend on this wrapper. Default item rendering is unchanged. For details, see the TreeView rendering changes.