Angular Version Compatibility for Syncfusion Components

22 Sep 20264 minutes to read

Supported Angular Versions

The following table provides compatibility information for Syncfusion® Angular UI components and supported Angular versions:

Angular Version Compatible Syncfusion® Angular Components Version
Angular v22 34.1.29 and above
Angular v21 31.1.17 and above
Angular v20 30.1.37 and above
Angular v19 26.1.35 to 34.2.9
Angular v18 25.2.3 to 34.2.9
Angular v17 23.2.4 to 34.2.9
Angular v16 21.1.39 to 34.2.9
Angular v15 20.4.38 to 34.2.9
Angular v14 20.2.36 to 34.2.9
Angular v13 19.4.38 to 34.2.9
Angular v12 19.3.43 to 34.2.9

Ivy and Non-Ivy Package Compatibility

Ivy is Angular’s default rendering engine, introduced in Angular 9, which provides improved build times and bundle sizes. View Engine is the legacy rendering engine used in earlier Angular versions. To support both Ivy and non-Ivy (View Engine) applications, Syncfusion® offers two package distributions:

  1. Ivy-compatible packages: These are the default packages and do not require any special suffix.

  2. Non-Ivy (View Engine) packages: For applications still using the View Engine, append the -ngcc suffix to the package version in the package.json file.

Starting from Syncfusion® Essential JS 2 Angular version 35.1.37, the ngcc package support has been dropped. Syncfusion® Angular components supports the latest official Angular version and the versions currently under long-term support (LTS) — that is, Angular versions 20, 21, and 22.

Usage of ngcc Packages

The Angular Compatibility Compiler (ngcc) transforms packages to work with Ivy-based applications. For Syncfusion® components, follow these guidelines:

  • Ivy-based applications (Angular 12 and above): Use the default packages without any suffix.

    Example:

    "@syncfusion/ej2-angular-grids": "20.2.38"

  • Non-Ivy applications (View Engine): Add the -ngcc suffix to the package version.

    Example:

    "@syncfusion/ej2-angular-grids": "20.2.38-ngcc"

Note: The -ngcc suffix is required only for versions 20.2.36 and later when using non-Ivy applications. For Ivy-based applications, which is the default for Angular 12 and above, use the packages without the suffix.

For detailed installation instructions, refer to the Angular package installation guide.

Understanding Syncfusion® Version Numbers

Syncfusion® follows a quarterly release cycle for major updates. The version numbering system for Syncfusion® Angular components uses semantic versioning in the format Major.Minor.Patch. This system allows developers to quickly understand the nature of each release.

For example, a release version 22.1.34 can be interpreted as follows:

22 - Major version (updated quarterly)
This number represents significant updates to the library. It may include major enhancements, new features, bug fixes, and potential breaking changes. Syncfusion® increments this number every three months as part of their quarterly release cycle.

1 - Minor version
The minor version indicates the release of new features and bug fixes that maintain backward compatibility. When Syncfusion® adds functionality in a backwards-compatible manner, they increment this number.

34 - Patch version
This number is incremented for weekly patch releases. These releases primarily consist of bug fixes and minor improvements that do not introduce new features or breaking changes.

By understanding this versioning system, developers can easily assess the impact and nature of each Syncfusion® update, helping them make informed decisions about when to upgrade their applications.

Staying Up-to-Date

To maintain stability, performance, and access to recent features, keep Syncfusion® Angular components updated to the latest version compatible with the Angular version in use. Benefits of regular updates include:

  • Access to new features and enhancements
  • Improved performance and reliability
  • Timely bug fixes and security updates

Additional Resources