From 07f8e265d1cc529a09708054cf55fd23bbb4ec6e Mon Sep 17 00:00:00 2001
From: Florent Le Borgne <florent.leborgne@elastic.co>
Date: Fri, 20 Jun 2025 17:01:19 +0200
Subject: [PATCH] Updates

---
 docs/reference/esql/esql-kibana.asciidoc | 28 +++++++++++++++++++++++-
 docs/reference/images/keyboard.svg       |  3 +++
 2 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 docs/reference/images/keyboard.svg

diff --git a/docs/reference/esql/esql-kibana.asciidoc b/docs/reference/esql/esql-kibana.asciidoc
index 5eb4f1d7a0446..c081ea86133eb 100644
--- a/docs/reference/esql/esql-kibana.asciidoc
+++ b/docs/reference/esql/esql-kibana.asciidoc
@@ -41,7 +41,7 @@ After switching to {esql} mode, the query bar shows your previous KQL or Lucene
 
 [source,esql]
 ----
-from kibana_sample_data_logs | limit 10
+FROM kibana_sample_data_logs | LIMIT 10
 ----
 
 Every query starts with a <<esql-commands,source command>>. In this query, the
@@ -224,6 +224,32 @@ FROM kibana_sample_data_logs
 | WHERE timestamp > NOW() - 15minutes
 ----
 
+
+==== Keyboard shortcuts
+
+The ES|QL editor supports several shortcuts to help you write and run your queries faster:
+
+|===
+| Mac | Windows/Linux | Description
+
+| `Cmd + Enter`
+| `Ctrl + Enter`
+| Run a query
+
+| `Cmd + /`
+| `Ctrl + /`
+| Comment or uncomment a line
+|===
+
+TIP: You can find the list of shortcuts directly from the editor. Look for the image:images/keyboard.svg[title=keyboard,width="2%"] icon.
+
+[float]
+=== LOOKUP JOINs
+
+The ES|QL editor supports {ref}/esql-commands.html#esql-lookup-join[`LOOKUP JOIN`] commands and suggests lookup mode indices and join condition fields.
+
+image::https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blte43a30a93241d650/67c23670045f5839e5bfd1e4/lookup-join-demo.gif[Using the LOOKUP JOIN command to autocomplete an ES|QL query]
+
 [discrete]
 [[esql-kibana-visualizations]]
 === Analyze and visualize data
diff --git a/docs/reference/images/keyboard.svg b/docs/reference/images/keyboard.svg
new file mode 100644
index 0000000000000..94e9663319835
--- /dev/null
+++ b/docs/reference/images/keyboard.svg
@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16">
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M0 3h16v11H0V3Zm15 10V4H1v9h14ZM2 5h2v1H2V5Zm2 7v-1H2v1h2Zm10-1v1h-2v-1h2Zm-3 1v-1H5v1h6ZM5 5h1v1H5V5ZM3 7H2v1h1V7Zm3 0h1v1H6V7ZM3 9H2v1h1V9Zm3 0h1v1H6V9Zm2-4H7v1h1V5ZM4 7h1v1H4V7Zm5 0H8v1h1V7Zm1 0h1v1h-1V7ZM5 9H4v1h1V9Zm3 0h1v1H8V9Zm3 0h-1v1h1V9ZM9 5h1v1H9V5Zm3 0h-1v1h1V5Zm1 0h1v1h-1V5Zm1 2h-2v3h2V7Z" />
+</svg>