diff --git a/guides/version-history.mdx b/guides/version-history.mdx
index 9b1f9c6f..54e6b9a1 100644
--- a/guides/version-history.mdx
+++ b/guides/version-history.mdx
@@ -49,6 +49,21 @@ To roll back a dashboard:
 Restoring a dashboard version also restores every chart saved within that version. Any changes made to those charts after the selected version will not appear once you roll back.
 </Note>
 
+### Known limitations
+
+Dashboard version history only tracks changes to the dashboard itself (layout, filters, tile positions). Chart changes are not recorded as separate dashboard versions — when you roll back, chart versions are restored based on the **timestamp** of the dashboard version you select.
+
+This means you can't selectively revert a single change. For example, if you:
+
+1. Create a dashboard.
+2. Add a chart (bar chart).
+3. Edit the chart to be a line chart.
+4. Add a filter to the dashboard.
+
+Rolling back step 4 from the dashboard version history will also revert step 3, because both chart versions are tied to dashboard version timestamps and only steps 1 and 2 exist as dashboard versions.
+
+For more granular control over chart changes, use the chart's own version history instead.
+
 ## Recently deleted charts and dashboards
 
 Charts and dashboards deleted in the last 30 days can be restored or permanently deleted from the **Recently deleted** page in project settings.