diff --git a/libbeat/docs/upgrading.asciidoc b/libbeat/docs/upgrading.asciidoc
index 5817c8babd23..9e312d22ff4a 100644
--- a/libbeat/docs/upgrading.asciidoc
+++ b/libbeat/docs/upgrading.asciidoc
@@ -37,6 +37,9 @@ We recommend that you fully upgrade {es} and {kib} to version 8.0
 before upgrading {beats}. The {beats} version must be lower than or equal to the
 {es} version. {beats} cannot send data to older versions of {es}.
 
+If you use the Uptime app in {kib}, make sure you add `heartbeat-8*` and `synthetics-*` to *Uptime indices*
+on the {observability-guide}/configure-uptime-settings.html[Settings page]. The first index is used by newer versions of {beatname_uc}, while the latter is used by {fleet}.
+
 If you're on {beats} 7.0 through 7.16, upgrade the {stack} and {beats} to
 version 7.17 *before* proceeding with the 8.0 upgrade.