---
title: Upgrade Notes
description: Important changes to consider when upgrading to Istio <!--newRelease-->.
weight: 20
---

{{< warning >}}
This is an automatically generated rough draft of the release notes and has not yet been reviewed.
{{< /warning >}}

When you upgrade from Istio <!--oldRelease--> to Istio <!--newRelease-->, you need to consider the changes on this page.
These notes detail the changes which purposefully break backwards compatibility with Istio <!--oldRelease-->.
The notes also mention changes which preserve backwards compatibility while introducing new behavior.
Changes are only included if the new behavior would be unexpected to a user of Istio <!--oldRelease-->.

<!-- upgradeNotes -->
