Angular Version Compatibility for Syncfusion^® Components

19 Aug 20253 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 v20	30.1.37 and above
Angular v19	26.1.35 and above
Angular v18	25.2.3 and above
Angular v17	23.2.4 and above
Angular v16	21.1.39 and above
Angular v15	20.4.38 and above
Angular v14	20.2.36 and above
Angular v13	19.4.38 and above
Angular v12	19.3.43 and above

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:

Ivy-compatible packages: These are the default packages and do not require any special suffix.
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.

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

Angular Version Compatibility for Syncfusion® Components