diff --git a/cinderclient/v2/shell.py b/cinderclient/v2/shell.py
index d9d05dd19..d4975dcd8 100644
--- a/cinderclient/v2/shell.py
+++ b/cinderclient/v2/shell.py
@@ -290,7 +290,9 @@ class CheckSizeArgForCreate(argparse.Action):
            dest='scheduler_hints',
            action='append',
            default=[],
-           help='Scheduler hint, like in nova.')
+           help='Scheduler hint, similar to nova. Repeat option to set '
+                'multiple hints. Values with the same key will be stored '
+                'as a list.')
 @utils.arg('--allow-multiattach',
            dest='multiattach',
            action="store_true",
diff --git a/cinderclient/v3/shell.py b/cinderclient/v3/shell.py
index d434fdc99..d0f1b95da 100644
--- a/cinderclient/v3/shell.py
+++ b/cinderclient/v3/shell.py
@@ -560,7 +560,9 @@ def do_reset_state(cs, args):
            dest='scheduler_hints',
            action='append',
            default=[],
-           help='Scheduler hint, like in nova.')
+           help='Scheduler hint, similar to nova. Repeat option to set '
+                'multiple hints. Values with the same key will be stored '
+                'as a list.')
 @utils.arg('--allow-multiattach',
            dest='multiattach',
            action="store_true",