From c19349a4ea3cab34882f40e6643f1846c639ef50 Mon Sep 17 00:00:00 2001
From: Pedro Mastelaro <phmastelaro@gmail.com>
Date: Wed, 4 Mar 2026 12:32:07 -0300
Subject: [PATCH 1/2] Update grafana.md

---
 .../plugins/available-plugins/grafana.md      | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/internal-developer-portal/plugins/available-plugins/grafana.md b/docs/internal-developer-portal/plugins/available-plugins/grafana.md
index 9dfff5f20e3..dfce56a5a7e 100644
--- a/docs/internal-developer-portal/plugins/available-plugins/grafana.md
+++ b/docs/internal-developer-portal/plugins/available-plugins/grafana.md
@@ -76,6 +76,31 @@ This plugin exports three UI cards that you can show on the **Overview** tab of
 
 ![](./static/dashboards_card.png)
 
+#### Full-height Grafana dashboard (important)
+If you want the embedded Grafana dashboard viewer to render taller (for example “full screen height”), set the height inside specs.gridProps.
+If you place height under specs.props.style, it may be ignored/overridden by the layout grid.
+
+✅ Supported example (recommended)
+```yaml
+- component: EntityOverviewDashboardViewer
+  specs:
+    gridProps:
+      md: 12
+      xs: 12
+      height: calc(100vh - 200px)
+```
+
+❌ Not recommended (may be ignored)
+```yaml
+    - component: EntityOverviewDashboardViewer
+      specs:
+        props:
+          style:
+            height: calc(100vh - 200px)
+```
+Why: the IDP Layout system applies sizing through the grid container, so height overrides should be provided via gridProps for consistent rendering.
+So, if you notice the dashboard suddenly rendering shorter after previously working, validate that the height is still defined in gridProps (layout-level), not props.style (component-level).
+
 ## Annotations
 
 To configure the plugin for a service in the software catalog, set the following annotations in its `catalog-info.yaml` definition file.

From db19a0226d5fc8f540394ea1fe63993bb67f26e6 Mon Sep 17 00:00:00 2001
From: Pedro Mastelaro <phmastelaro@gmail.com>
Date: Wed, 4 Mar 2026 13:01:38 -0300
Subject: [PATCH 2/2] Update grafana.md

---
 .../plugins/available-plugins/grafana.md               | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/internal-developer-portal/plugins/available-plugins/grafana.md b/docs/internal-developer-portal/plugins/available-plugins/grafana.md
index dfce56a5a7e..a3e4dfbff42 100644
--- a/docs/internal-developer-portal/plugins/available-plugins/grafana.md
+++ b/docs/internal-developer-portal/plugins/available-plugins/grafana.md
@@ -92,11 +92,11 @@ If you place height under specs.props.style, it may be ignored/overridden by the
 
 ❌ Not recommended (may be ignored)
 ```yaml
-    - component: EntityOverviewDashboardViewer
-      specs:
-        props:
-          style:
-            height: calc(100vh - 200px)
+- component: EntityOverviewDashboardViewer
+  specs:
+    props:
+      style:
+        height: calc(100vh - 200px)
 ```
 Why: the IDP Layout system applies sizing through the grid container, so height overrides should be provided via gridProps for consistent rendering.
 So, if you notice the dashboard suddenly rendering shorter after previously working, validate that the height is still defined in gridProps (layout-level), not props.style (component-level).