diff --git a/packages/ui-heading/src/Heading/v2/README.md b/packages/ui-heading/src/Heading/v2/README.md
index b9aaee9d0b..2e63ebf7df 100644
--- a/packages/ui-heading/src/Heading/v2/README.md
+++ b/packages/ui-heading/src/Heading/v2/README.md
@@ -42,19 +42,78 @@ type: example
### AI Heading
-Pre-configured and with unique styles, the `ai-headings` are used for standardized, ai-related components.
+Use the `aiVariant` prop for headings of AI-related content, such as a Modal or Popover header. Use a standard Heading for all other headings.
+
+`stacked` and `horizontal` show the IgniteAI logo lockup before the heading text:
```js
---
type: example
---
- Nutrition Facts
- Nutrition Facts
- Nutrition Facts
+ Stacked AI heading
+ Horizontal AI heading
+
+```
+
+`iconOnly` shows only the AI icon, and it comes in the same sizes as the standard Heading. Set the size with the `variant` or `level` prop, and the icon scales to match:
+
+```js
+---
+type: example
+---
+