diff --git a/man/man5/zfs-module-parameters.5 b/man/man5/zfs-module-parameters.5
index d9be70e235a4..c711f6de61bf 100644
--- a/man/man5/zfs-module-parameters.5
+++ b/man/man5/zfs-module-parameters.5
@@ -3188,8 +3188,10 @@ Default value: \fB32,768\fR.
 \fBzfs_vdev_scheduler\fR (charp)
 .ad
 .RS 12n
-Set the Linux I/O scheduler on whole disk vdevs to this scheduler. Valid options
-are noop, cfq, bfq & deadline
+Set the Linux I/O scheduler on whole disk vdevs to this scheduler.  This
+option has been deprecated and will be removed in a future release.  The
+standard \fB/sys/block/<block>/queue/scheduler\fR interface should be used
+to set a block device scheduler.
 .sp
 Default value: \fBnoop\fR.
 .RE
diff --git a/module/os/linux/zfs/vdev_disk.c b/module/os/linux/zfs/vdev_disk.c
index d223ef3b30ae..8490f1db16f1 100644
--- a/module/os/linux/zfs/vdev_disk.c
+++ b/module/os/linux/zfs/vdev_disk.c
@@ -930,7 +930,14 @@ param_set_vdev_scheduler(const char *val, zfs_kernel_param_t *kp)
 		mutex_exit(&spa_namespace_lock);
 	}
 
-	return (param_set_charp(val, kp));
+
+	int error = param_set_charp(val, kp);
+	if (error == 0) {
+		printk(KERN_INFO "The 'zfs_vdev_scheduler' module option "
+		    "will be removed in a future release.\n");
+	}
+
+	return (error);
 }
 
 vdev_ops_t vdev_disk_ops = {