---
navigation_title: "Breaking changes"
mapped_pages:
  - https://www.elastic.co/guide/en/elasticsearch/reference/current/breaking-changes.html
---

# Elasticsearch breaking changes [elasticsearch-breaking-changes]

Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the Elasticsearch breaking changes and take the necessary steps to mitigate any issues.

If you are migrating from a version prior to version 9.0, you must first upgrade to the last 8.x version available. To learn how to upgrade, check out [Upgrade](docs-content://deploy-manage/upgrade.md).

% ## Next version [elasticsearch-nextversion-breaking-changes]
<%
for(bundle in changelogBundles) {
    def version = bundle.version
    def versionForIds = bundle.version.toString().equals('9.0.0') ? bundle.versionWithoutSeparator : bundle.version
    def changelogsByTypeByArea = bundle.changelogsByTypeByArea
    def unqualifiedVersion = bundle.unqualifiedVersion
    def coming = !bundle.bundle.released

    if (coming) {
        print "\n"
        print "```{applies_to}\n"
        print "stack: coming ${version}\n"
        print "```"
    }
%>
## ${unqualifiedVersion} [elasticsearch-${versionForIds}-breaking-changes]
<%
    if (!changelogsByTypeByArea['breaking']) {
        print "\nNo breaking changes in this version.\n"
    } else {
        for (team in (changelogsByTypeByArea['breaking'] ?: [:]).keySet()) {
            print "\n${team}:\n";

            for (change in changelogsByTypeByArea['breaking'][team]) {
                print "* ${change.summary} [#${change.pr}](https://github.com/elastic/elasticsearch/pull/${change.pr})"
                if (change.issues != null && change.issues.empty == false) {
                    print change.issues.size() == 1 ? " (issue: " : " (issues: "
                    print change.issues.collect { "[#${it}](https://github.com/elastic/elasticsearch/issues/${it})" }.join(", ")
                    print ")"
                }
                print "\n"
            }
        }

        print "\n\n"
    }
}