diff --git a/docs/detections/alerts-view-details.asciidoc b/docs/detections/alerts-view-details.asciidoc
index 83ba78e3dc..b4e7f1699c 100644
--- a/docs/detections/alerts-view-details.asciidoc
+++ b/docs/detections/alerts-view-details.asciidoc
@@ -38,6 +38,8 @@ NOTE: If you've configured the {kibana-ref}/settings.html#server-publicBaseUrl[`
 +
 IMPORTANT: If you've enabled grouping on the Alerts page, the alert details flyout won't open until you expand a collapsed group and select an individual alert.
 
+* Click the **Flyout settings** icon (image:images/flyout-settings.png[Flyout settings icon,15,15]) to access options for displaying the alert details flyout. The **Overlay** option (which displays the flyout over the Alerts table) is selected by default. Select **Push** to display the flyout to the side of the table instead. In either display, you can resize the flyout panels to your liking. Clicking **Reset size** reverts the flyout to its default dimensions. 
+
 * Find basic details about the alert, such as the:
 
 ** Associated rule
diff --git a/docs/detections/images/flyout-settings.png b/docs/detections/images/flyout-settings.png
new file mode 100644
index 0000000000..a7f23f0df1
Binary files /dev/null and b/docs/detections/images/flyout-settings.png differ