diff --git a/app/assets/images/lookbook/user_hover_card.png b/app/assets/images/lookbook/user_hover_card.png
new file mode 100644
index 000000000000..b225bcfad038
Binary files /dev/null and b/app/assets/images/lookbook/user_hover_card.png differ
diff --git a/lookbook/docs/patterns/25-hover-cards.md.erb b/lookbook/docs/patterns/25-hover-cards.md.erb
index 219ccad1830d..18474ed9eaee 100644
--- a/lookbook/docs/patterns/25-hover-cards.md.erb
+++ b/lookbook/docs/patterns/25-hover-cards.md.erb
@@ -2,7 +2,9 @@ The HoverCard is a pattern related to the `Primer::Beta::Popover` and is used to
 
 ## Overview
 
-![Exemplary hover card](<%= image_path('lookbook/hover_card.png') %>)
+![Exemplary work package hover card](<%= image_path('lookbook/hover_card.png') %>)
+
+![Exemplary user hover card](<%= image_path('lookbook/user_hover_card.png') %>)
 
 ## Anatomy
 
diff --git a/lookbook/previews/open_project/users/avatar_component_preview.rb b/lookbook/previews/open_project/users/avatar_component_preview.rb
index fe647903a0c7..b2e500a4281d 100644
--- a/lookbook/previews/open_project/users/avatar_component_preview.rb
+++ b/lookbook/previews/open_project/users/avatar_component_preview.rb
@@ -3,7 +3,8 @@
 module OpenProject::Users
   # @logical_path OpenProject/Users
   class AvatarComponentPreview < Lookbook::Preview
-    # Renders a user avatar using the OpenProject opce-principal web component
+    # Renders a user avatar using the OpenProject opce-principal web component. Note that the hover card options
+    # have no effect in this lookbook.
     # @param size select { choices: [default, medium, mini] }
     # @param link toggle
     # @param show_name toggle