v20 Migration Guide

This document will help you upgrade from ng-zorro-antd 19.x version to 20.x version.

Before upgrade#

1. Make sure Node.js >= 20.19.0 or >= 22.12.0 or >= 24.0.0.
2. Create a new branch, or use other methods to back up the current project.
3. Delete the package-lock.json file.

1. Upgrade dependencies#

• Upgrade Angular to 20.x version, ref https://angular.dev/update-guide.
• Run ng update @angular/cdk, if you have used @angular/cdk.

2. Upgrade NG-ZORRO#

• Run ng update ng-zorro-antd.
• If any warning messages appear in the console, follow the prompts to modify the corresponding code.

3. Remove deprecated APIs#

• Remove deprecated APIs, please refer to the v20 changelog for more information.