diff --git a/docs/content/3.components/avatar.md b/docs/content/3.components/avatar.md
index bf52e130..a5dd86ca 100644
--- a/docs/content/3.components/avatar.md
+++ b/docs/content/3.components/avatar.md
@@ -1,5 +1,5 @@
 ---
-description: An image element with fallback.
+description: An img element with fallback and Nuxt Image support.
 links:
   - label: Avatar
     icon: i-custom-radix-vue
@@ -12,7 +12,7 @@ links:
 ## Usage
 
 ::tip
-The Avatar uses the `NuxtImg` component when `@nuxt/image` is installed, falling back to `img` otherwise.
+The Avatar uses the `NuxtImg` component when [`@nuxt/image`](https://github.com/nuxt/image) is installed, falling back to `img` otherwise.
 ::
 
 ### Src
@@ -40,6 +40,10 @@ props:
 ---
 ::
 
+::note
+The `<img>` element's `width` and `height` are automatically set based on the `size` prop.
+::
+
 ### Icon
 
 Use the `icon` prop to display a fallback [Icon](/components/icon).