Angular Data GridDeprecation policy

Deprecation occurs when better alternatives emerge that offer improved performance, security, or usability compared to existing implementations. It also helps maintain API consistency by removing redundant or inconsistent functions, creating a cleaner overall design. As web standards and the JavaScript ecosystem evolve, certain approaches become obsolete or suboptimal, requiring updates to stay current. Additionally, deprecation reduces maintenance complexity by phasing out rarely-used or problematic features, while addressing potential security vulnerabilities in older implementations. Rather than introducing breaking changes, deprecation provides a gradual migration path that gives developers time to adapt while clearly signaling the library's future direction.

After a Handsontable feature, a framework wrapper or any other part of the API is marked deprecated, we commit to a grace period (at least 3 months) during which the deprecated feature still works. We will not remove the feature immediately in the next minor or patch release. Instead, removal is deferred until a future major release, in accordance with semantic versioning.

On this page

• Support
• Relation to LTS
• Deprecation notifications
• List of deprecations

Support

During the deprecation period:

• We will fix critical bugs and security vulnerabilities in the deprecated feature.
• We will not add new enhancements for deprecated APIs.
• Full stability and long-term support are guaranteed only within LTS releases.

Relation to LTS

Handsontable follows a Long-Term Support (LTS) model, where every even-numbered major release becomes an LTS release with ~30 months of support. For more details, please visit Long Term Support.

Deprecation notifications

We will announce deprecations and removals through release notes accompanied by blog posts. Additionally, deprecated features may show console warnings in development builds. Deprecated APIs will be clearly marked in our documentation with a recommended alternative (if possible).

For significant deprecations (especially those affecting many users), we will provide dedicated Migration Guides.

For more details about our versioning policy please visit Versioning policy

List of deprecations

Below is a list of current deprecations that are planned to be removed in next major version.

	Reference	Migration guide
React class-based wrapper	npm package (opens new window)	Migrate to New React Wrapper
Angular legacy wrapper	npm package (opens new window)	Switch to new Angular wrapper
Vue2 wrapper	npm package (opens new window)	Move to Vue 3
Legacy style	Documentation	Migrate to Classic Theme
persistentState plugin	API Reference	Please update your settings to ensure compatibility with future versions.
hot.undo method	API Reference	Replace with UndoRedo plugin undo method.
hot.redo method	API Reference	Replace with UndoRedo plugin redo method.
hot.isUndoAvailable method	API Reference	Replace with UndoRedo plugin isUndoAvailable method.
hot.isRedoAvailable method	API Reference	Replace with UndoRedo plugin isRedoAvailable method.
hot.clearUndo method	API Reference	Replace with UndoRedo plugin clear method.