diff --git a/docs/logs/images/logs-stream-highlight-box.png b/docs/logs/images/logs-stream-highlight-box.png
new file mode 100644
index 0000000000000..1a6cb2b59dd59
Binary files /dev/null and b/docs/logs/images/logs-stream-highlight-box.png differ
diff --git a/docs/logs/images/logs-stream-highlight-entries.png b/docs/logs/images/logs-stream-highlight-entries.png
new file mode 100644
index 0000000000000..d23c7c9853304
Binary files /dev/null and b/docs/logs/images/logs-stream-highlight-entries.png differ
diff --git a/docs/logs/using.asciidoc b/docs/logs/using.asciidoc
index 3b17c72c6476f..21902a94c45b8 100644
--- a/docs/logs/using.asciidoc
+++ b/docs/logs/using.asciidoc
@@ -72,6 +72,19 @@ image::logs/images/logs-usage-streaming-indicator.png[Logs streaming indicator]
 
 Historical data offers infinite scrolling.
 
+[float]
+[[logs-highlight]]
+=== Highlight a phrase in the logs stream
+To find instances of a particular word or phrase in the logs stream, click the Highlights button in the toolbar and enter your search terms.
+
+[role="screenshot"]
+image::logs/images/logs-stream-highlight-box.png[Logs highlight dialog box]
+
+This will highlight any instances of your search terms that appear in the logs stream.
+
+[role="screenshot"]
+image::logs/images/logs-stream-highlight-entries.png[Logs stream with the search term 'safepoint' highlighted]
+
 [float]
 [[logs-event-inspector]]
 === Inspect a log event