diff --git a/website/source/docs/job-specification/update.html.md b/website/source/docs/job-specification/update.html.md
index 953a7239d..cd3631119 100644
--- a/website/source/docs/job-specification/update.html.md
+++ b/website/source/docs/job-specification/update.html.md
@@ -43,6 +43,10 @@ job "docs" {
 }
 ```
 
+~> For `system` jobs, only `max_parallel` and `stagger` are enforced. The job is
+updated at a rate of `max_parallel`, waiting `stagger` duration before the next
+set of updates. The `system` scheduler will be updated to support the new
+`update` stanza in a future release.
 
 ## `update` Parameters