diff --git a/docs/user/alerting/alerting-setup.asciidoc b/docs/user/alerting/alerting-setup.asciidoc
index b6b836872b06fb..84ad2b365ce073 100644
--- a/docs/user/alerting/alerting-setup.asciidoc
+++ b/docs/user/alerting/alerting-setup.asciidoc
@@ -5,6 +5,8 @@
Setup
++++
+The Alerting feature is automatically enabled in {kib} but may require some additional configuration.
+
[float]
[[alerting-prerequisites]]
=== Prerequisites
@@ -42,6 +44,12 @@ To access alerting in a space, a user must have access to one of the following f
See <> for more information on configuring roles that provide access to these features.
Also note that a user will need +read+ privileges for the *Actions and Connectors* feature to attach actions to a rule or to edit a rule that has an action attached to it.
+[float]
+[[alerting-restricting-actions]]
+==== Restrict actions
+
+For security reasons you may wish to limit the extent to which {kib} can connect to external services. <> allows you to disable certain <> and allowlist the hostnames that {kib} can connect with.
+
[float]
[[alerting-spaces]]
=== Space isolation
@@ -58,9 +66,3 @@ Rules, including all background detection and the actions they generate are auth
==============================================
If a rule requires certain privileges to run, such as index privileges, keep in mind that if a user without those privileges updates the rule, the rule will no longer function.
==============================================
-
-[float]
-[[alerting-restricting-actions]]
-=== Restrict actions
-
-For security reasons you may wish to limit the extent to which {kib} can connect to external services. <> allows you to disable certain <> and allowlist the hostnames that {kib} can connect with.