From 3551c33c1066da3533bbea1b3b896ff48487928a Mon Sep 17 00:00:00 2001
From: nsumbadze <137318896+nsumbadze@users.noreply.github.com>
Date: Thu, 16 Jul 2026 12:49:08 +0400
Subject: [PATCH] docs(readme): document image search

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 97967d36..ee181b4c 100644
--- a/README.md
+++ b/README.md
@@ -267,6 +267,16 @@ echo "alias lzd='lazydocker'" >> ~/.zshrc
 - List of keybindings
   [here](/docs/keybindings).
 
+### Search and pull images
+
+Focus the **Images** panel and press <kbd>Shift</kbd>+<kbd>I</kbd> to search Docker Hub repositories as you type. Use <kbd>↑</kbd>/<kbd>↓</kbd> to select a repository and press <kbd>Enter</kbd> to browse its tags.
+
+<!-- Screenshot placeholder: live Docker Hub repository search -->
+
+The tag search shows the exact image reference, Docker Hub size, last-pushed time, supported platforms, digest, and media type. Press <kbd>Enter</kbd> on a tag to pull it and refresh the Images panel.
+
+<!-- Screenshot placeholder: live Docker Hub tag search and image metadata -->
+
 ## Cool features
 
 everything is one keypress away (or one click away! Mouse support FTW):