Restore dashboards: Add limitations to the docs (#112848)

* Restore dashboards: Document limitations

* Update settings modal text

* Add version history limits

* Update docs/sources/visualizations/dashboards/manage-dashboards/index.md

Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com>

* Apply suggestion from @imatwawana

Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com>

* Update public/app/features/dashboard-scene/settings/DeleteDashboardButton.tsx

Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com>

* Update docs/sources/visualizations/dashboards/manage-dashboards/index.md

Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com>

* Feedback

---------

Co-authored-by: Isabel Matwawana <76437239+imatwawana@users.noreply.github.com>

docs/sources/visualizations/dashboards/manage-dashboards/index.md

@@ -133,6 +133,10 @@ After this limit is reached, the oldest deleted dashboards are permanently remov
 
 You can access the list of deleted dashboards from the **Dashboards** page by clicking the **Recently deleted** button, or by navigating to **Dashboards > Recently deleted**.
 
+{{% admonition type="note" %}}
+Only users with admin rights can access the **Restore dashboards** page.
+{{% /admonition %}}
+
 To restore one or more dashboards, follow these steps:
 
 1. In the main menu, click **Dashboards > Recently deleted** or click the **Recently deleted** button from the **Dashboards** page.
@@ -144,9 +148,13 @@ To restore one or more dashboards, follow these steps:
    - If the original folder no longer exists, you’ll need to select a new target folder.
 4. Click **Restore**.
 
-{{% admonition type="note" %}}
-Only users with admin rights can access the **Restore dashboards** page.
-{{% /admonition %}}
+### Limitations
+
+Restoring dashboards has the following limitations:
+
+- **Permissions aren't preserved** - Dashboard-specific permissions are not restored. After restoration, you'll need to manually reconfigure any custom permissions that were previously set on the dashboard.
+- **Folder-level permissions apply** - Restored dashboards inherit the permissions of the target folder you select during restoration.
+- **Version history is reset** - The dashboard's version history is not preserved. After restoration, the dashboard starts with version 1, and all previous versions are lost.
 
 ## Set up generative AI features for dashboards
 

public/app/features/dashboard-scene/settings/DeleteDashboardButton.tsx

@@ -80,8 +80,9 @@ export function DeleteDashboardModal({ dashboardTitle, onConfirm, onClose }: Del
             <>
               <Text element="p">
                 <Trans i18nKey="dashboard-settings.delete-modal-restore-dashboards-text">
-                  This action will mark the dashboard for deletion in 30 days. Your organization administrator can
-                  restore it anytime before the 30 days expire.
+                  This action will delete the dashboard. Deleted dashboards will be kept in the history for up to 12
+                  months and can be restored by your organization administrator during that time. The history is limited
+                  to 1000 dashboards—older ones will be removed sooner if the limit is reached.
                 </Trans>
               </Text>
               <Space v={1} />

public/locales/en-US/grafana.json

@@ -6559,7 +6559,7 @@
       "delete-button": "Delete",
       "title": "Delete"
     },
-    "delete-modal-restore-dashboards-text": "This action will mark the dashboard for deletion in 30 days. Your organization administrator can restore it anytime before the 30 days expire.",
+    "delete-modal-restore-dashboards-text": "This action will delete the dashboard. Deleted dashboards will be kept in the history for up to 12 months and can be restored by your organization administrator during that time. The history is limited to 1000 dashboards—older ones will be removed sooner if the limit is reached.",
     "delete-modal-text": "Do you want to delete this dashboard?",
     "general": {
       "auto-refresh-description": "Define the auto refresh intervals that should be available in the auto refresh list. Use the format '5s' for seconds, '1m' for minutes, '1h' for hours, and '1d' for days (e.g.: '5s,10s,30s,1m,5m,15m,30m,1h,2h,1d').",