elastic · Zacqary · Jul 22, 2019 · Jul 19, 2019 · Jul 19, 2019 · Jul 22, 2019
diff --git a/docs/logs/images/logs-stream-highlight-box.png b/docs/logs/images/logs-stream-highlight-box.png
diff --git a/docs/logs/images/logs-stream-highlight-entries.png b/docs/logs/images/logs-stream-highlight-entries.png
diff --git 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