v18 Migration Guide

This document will help you upgrade from ng-zorro-antd 17.x version to 18.x version.

Before upgrade#

  1. Make sure Node.js >= 18.19.1 or >= 20.11.0 or >= 22.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#

2. Upgrade NG-ZORRO#

For projects built in standalone, you need to update ng-zorro-antd manually

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