diff --git a/content/en/cloud/academy/creating-your-learning-path/index.md b/content/en/cloud/academy/creating-your-learning-path/index.md
index fdee8f111..a7f175fbb 100644
--- a/content/en/cloud/academy/creating-your-learning-path/index.md
+++ b/content/en/cloud/academy/creating-your-learning-path/index.md
@@ -170,7 +170,16 @@ Enhance your course with images and other visual aids. The recommended and stand
For all assets, please use the Page Bundling method. It simplifies asset management by co-locating images with the Markdown files that use them.
{{< /alert >}}
-**How to Add an Image**
+### Size Limits for Embedded Media
+While there's no hard-coded size limit, we enforce these practical constraints:
+| Media Type | Recommended Max Size | Impact Beyond Limit |
+|------------|----------------------|------------------------------|
+| Video | 50 MB | Slow builds, CI failures |
+| Image | 5 MB | Hugo memory overflow |
+| PDF | 20 MB | Browser loading delays |
+
+
+### How to Add an Image
1. Place your image file (e.g., `hugo-logo.png`) in the **same directory** as your Markdown file (e.g., `01-pods.md`).
@@ -184,18 +193,44 @@ For all assets, please use the Page Bundling method. It simplifies asset managem
The `usestatic` shortcode is **deprecated** and should not be used!
{{< /alert >}}
-**How to Add a Video**
+### How to Add a Video
+
+**Page Bundling (Recommended)**
+```markdown
+
+```
-```text
-{{* card
-title="Video: Example" */>}}
-