Compare Angular versions and see exactly what changes, what requires action, and what you can start using.
UpgradePath detects relevant tools and selects them automatically.
Select the tools in your project to include relevant dependency updates in this guide.
These guides cover each major's initial minor line (for example, 20.0.x). Commands select its latest patch. Later minors can have different toolchain ranges. Review the official update guide for the complete checklist.
^18.19.1 || ^20.11.1 || ^22.0.0>=5.5.0 <5.7.0^6.5.3 || ^7.4.0ng update @angular/cli@~19.0 @angular/core@~19.0Check this step's runtime first, review migration edits, then build and test before proceeding. Keep Angular core, compiler and CLI aligned. Update Material/CDK and other integrations with their own migrations when installed.
^20.19.0 || ^22.12.0 || ^24.0.0>=5.8.0 <5.9.0^6.5.3 || ^7.4.0ng update @angular/cli@~20.0 @angular/core@~20.0Check this step's runtime first, review migration edits, then build and test before proceeding. Keep Angular core, compiler and CLI aligned. Update Material/CDK and other integrations with their own migrations when installed.
^20.19.0 || ^22.12.0 || ^24.0.0>=5.9.0 <6.0.0^6.5.3 || ^7.4.0ng update @angular/cli@~21.0 @angular/core@~21.0Check this step's runtime first, review migration edits, then build and test before proceeding. Keep Angular core, compiler and CLI aligned. Update Material/CDK and other integrations with their own migrations when installed.
Components, directives and pipes default to standalone. Existing NgModule declarations need an explicit opt-out.
@Component({ selector: "app-example", template: "Hello" })
export class ExampleComponent {}// For a component still declared by an NgModule:
@Component({ standalone: false, selector: "app-example", template: "Hello" })
export class ExampleComponent {}Run the CLI migration, then check NgModule declarations for standalone: false.
The render hook has a new name. Update imports and calls during migration.
Replace afterRender with afterEveryRender and review any render-dependent tests.
The deprecated TestBed.get API is removed.
Update test service lookups to TestBed.inject with typed provider tokens.
Review code that depends on Zone.js notifications. The update migration preserves zone-based behavior where needed.
Review generated providers before removing Zone.js. Test UI updates, third-party integrations and async rendering.
Redirect functions can now resolve asynchronously.
Consider asynchronous redirects when route decisions depend on asynchronously available data.
Angular 21 introduces experimental signal-based forms alongside existing forms APIs.
Evaluate in an isolated feature; upgrading does not require rewriting existing forms.
Previously hidden type mismatches in host bindings can become compiler errors.
Build the application and correct incompatible host binding values.
Effects can run at different points in change detection. Tests that assumed microtask timing may need adjustment.
Exercise signal-driven components and wait for Angular stability before asserting asynchronous UI changes.
createComponent renders fallback content when projectableNodes contains an empty slot.
Check dynamic component projection. Pass an empty text node when deliberately suppressing fallback content.
NgIf, NgFor and NgSwitch are deprecated in favor of built-in template control flow.
<p *ngIf="ready">Ready</p>@if (ready) { <p>Ready</p> }Review the control-flow migration and test tracking behavior after converting templates.