diff --git a/docs/en/install-upgrade/upgrading-stack.asciidoc b/docs/en/install-upgrade/upgrading-stack.asciidoc index 4219c92ac..8b6dcfd8c 100644 --- a/docs/en/install-upgrade/upgrading-stack.asciidoc +++ b/docs/en/install-upgrade/upgrading-stack.asciidoc @@ -9,6 +9,21 @@ These steps vary based on your current version: * <> endif::[] +[IMPORTANT] +.Out-of-order releases +==== +Elastic maintains several minor versions of the Elastic Stack at once. This +means releases do not always happen in order of their version numbers. You can +only upgrade to {version} if the version you are currently running meets both +of these conditions: + +* Has an older version number than {version}. +* Has an earlier release date than {version}. + +If you are currently running a version with an older version number but a later +release date than {version}, wait for a newer release before upgrading. +==== + IMPORTANT: Upgrading from a release candidate build, such as 8.0.0-rc1 or 8.0.0-rc2, is not supported. Pre-releases should only be used for testing in a temporary environment.