diff --git a/docs/reference/commandline/service_create.md b/docs/reference/commandline/service_create.md
index 4c72b3ac6d..1875f0aca7 100644
--- a/docs/reference/commandline/service_create.md
+++ b/docs/reference/commandline/service_create.md
@@ -23,6 +23,8 @@ Create a new service
 Options:
       --constraint list                    Placement constraints (default [])
       --container-label list               Container labels (default [])
+  -d, --detach                             Exit immediately instead of waiting for the service to converge
+                                           (default true)
       --dns list                           Set custom DNS servers (default [])
       --dns-option list                    Set DNS options (default [])
       --dns-search list                    Set custom DNS search domains (default [])
diff --git a/docs/reference/commandline/service_update.md b/docs/reference/commandline/service_update.md
index 3c416d2e7a..040d5d95a1 100644
--- a/docs/reference/commandline/service_update.md
+++ b/docs/reference/commandline/service_update.md
@@ -26,6 +26,8 @@ Options:
       --constraint-rm list                 Remove a constraint (default [])
       --container-label-add list           Add or update a container label (default [])
       --container-label-rm list            Remove a container label by its key (default [])
+  -d, --detach                             Exit immediately instead of waiting for the service to converge
+                                           (default true)
       --dns-add list                       Add or update a custom DNS server (default [])
       --dns-option-add list                Add or update a DNS option (default [])
       --dns-option-rm list                 Remove a DNS option (default [])