diff --git a/source/_integrations/synologydsm.markdown b/source/_integrations/synologydsm.markdown
index 29c40eb41df..cad8a19a30d 100644
--- a/source/_integrations/synologydsm.markdown
+++ b/source/_integrations/synologydsm.markdown
@@ -29,7 +29,7 @@ sensor:
 
 {% configuration %}
 name:
-  description: The name of your device
+  description: The name to use in the frontend for your Synology device.
   required: false
   default: Synology DSM
   type: string
@@ -56,11 +56,11 @@ ssl:
   default: true
   type: boolean
 volumes:
-  description: Array of volumes to monitor. Defaults to all volumes.
+  description: "Array of volumes to monitor. Defaults to all volumes. Replace any spaces in the volume name with underscores, e.g., `volume 1` with `volume_1`."
   required: false
   type: list
 disks:
-  description: Array of disks to monitor. Defaults to all disks.
+  description: "Array of disks to monitor. Defaults to all disks. Use only disk names like `sda`, `sdb`, etc."
   required: false
   type: list
 monitored_conditions: