diff --git a/packages/webawesome/docs/docs/components/card.md b/packages/webawesome/docs/docs/components/card.md
index bbca071f4..45f10a62d 100644
--- a/packages/webawesome/docs/docs/components/card.md
+++ b/packages/webawesome/docs/docs/components/card.md
@@ -100,19 +100,20 @@ If using SSR, you need to also use the `with-media` attribute to add a media sec
```html {.example}
-
- This is a kitten, but not just any kitten. This kitten likes walking along pallets.
+
+
+
+ This card has an image of a kitten walking along a pallet.
- This is a kitten, but not just any kitten. This kitten likes walking along pallets.
+ This card has a video of a dog wearing shades.
@@ -153,10 +154,10 @@ Use the `appearance` attribute to change the card's visual appearance.
### Orientation
Set the `orientation` attribute to `horizontal` to create a card with a horizontal, side-by-side layout. Make sure to set a width or maximum width for the media slot. Horizontal cards do not currently contain the header and footer slots.
-
-
+
+:::info
The `actions` slot is only available for the horizontal orientation
-
+:::
```html {.example}
@@ -166,7 +167,7 @@ The `actions` slot is only available for the horizontal orientation
src="https://images.unsplash.com/photo-1559209172-0ff8f6d49ff7?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=500&q=80"
alt="A kitten sits patiently between a terracotta pot and decorative grasses."
/>
- This is a kitten, but not just any kitten. This kitten likes walking along pallets.
+ This card has a horizontal orientation with media, body, and actions arranged side-by-side.