diff --git a/docs/reference/commandline/service_create.md b/docs/reference/commandline/service_create.md
index c265205c09..d5df309bbb 100644
--- a/docs/reference/commandline/service_create.md
+++ b/docs/reference/commandline/service_create.md
@@ -40,7 +40,7 @@ Options:
       --restart-window value         Window used to evaluate the restart policy (default none)
       --stop-grace-period value      Time to wait before force killing a container (default none)
       --update-delay duration        Delay between updates
-      --update-parallelism uint      Maximum number of tasks updated simultaneously
+      --update-parallelism uint      Maximum number of tasks updated simultaneously (0 to update all at once) (default 1)
   -u, --user string                  Username or UID
       --with-registry-auth           Send registry authentication details to Swarm agents
   -w, --workdir string               Working directory inside the container
diff --git a/docs/reference/commandline/service_update.md b/docs/reference/commandline/service_update.md
index 25817e115c..2405dd4090 100644
--- a/docs/reference/commandline/service_update.md
+++ b/docs/reference/commandline/service_update.md
@@ -47,7 +47,7 @@ Options:
       --restart-window value         Window used to evaluate the restart policy (default none)
       --stop-grace-period value      Time to wait before force killing a container (default none)
       --update-delay duration        Delay between updates
-      --update-parallelism uint      Maximum number of tasks updated simultaneously
+      --update-parallelism uint      Maximum number of tasks updated simultaneously (0 to update all at once) (default 1)
   -u, --user string                  Username or UID
       --with-registry-auth           Send registry authentication details to Swarm agents
   -w, --workdir string               Working directory inside the container