diff --git a/docs/sources/administration/roles-and-permissions/access-control/custom-role-actions-scopes/index.md b/docs/sources/administration/roles-and-permissions/access-control/custom-role-actions-scopes/index.md
index 8a424bc3c67..ff097506b2e 100644
--- a/docs/sources/administration/roles-and-permissions/access-control/custom-role-actions-scopes/index.md
+++ b/docs/sources/administration/roles-and-permissions/access-control/custom-role-actions-scopes/index.md
@@ -74,7 +74,7 @@ The following list contains role-based access control actions.
| `banners:write` | None | Create [announcement banners](/docs/grafana-cloud/whats-new/2024-09-10-announcement-banner/). |
| `dashboards:create` |
- `folders:*`
- `folders:uid:*`
| Create dashboards in one or more folders and their subfolders. |
| `dashboards:delete` | - `dashboards:*`
- `dashboards:uid:*`
- `folders:*`
- `folders:uid:*`
| Delete one or more dashboards. |
-| `dashboards.insights:read` | None | Read dashboard insights data and see presence indicators. |
+| `dashboards.insights:read` | None | Read dashboard insights data and see presence indicators. To view insights, `dashboards:read` on the dashboard is also needed. |
| `dashboards.permissions:read` | - `dashboards:*`
- `dashboards:uid:*`
- `folders:*`
- `folders:uid:*`
| Read permissions for one or more dashboards. |
| `dashboards.permissions:write` | - `dashboards:*`
- `dashboards:uid:*`
- `folders:*`
- `folders:uid:*`
| Update permissions for one or more dashboards. |
| `dashboards:read` | - `dashboards:*`
- `dashboards:uid:*`
- `folders:*`
- `folders:uid:*`
| Read one or more dashboards. |
@@ -86,7 +86,7 @@ The following list contains role-based access control actions.
| `datasources:delete` | - `datasources:*`
- `datasources:uid:*`
| Delete data sources. |
| `datasources:explore` | None | Enable access to the **Explore** tab. |
| `datasources.id:read` | - `datasources:*`
- `datasources:uid:*`
| Read data source IDs. |
-| `datasources.insights:read` | None | Read data sources insights data. |
+| `datasources.insights:read` | None | Read data sources insights data. To view insights, `datasources:read` on the datasource is also needed. |
| `datasources.permissions:read` | - `datasources:*`
- `datasources:uid:*`
| List data source permissions. |
| `datasources.permissions:write` | - `datasources:*`
- `datasources:uid:*`
| Update data source permissions. |
| `datasources:query` | - `datasources:*`
- `datasources:uid:*`
| Query data sources. |