diff --git a/README.md b/README.md
index ad80479e..6359aeae 100644
--- a/README.md
+++ b/README.md
@@ -84,6 +84,9 @@ spec:
     apiVersion: apps/v1
     kind: Deployment
     name: podinfo
+  # the maximum time in seconds for the canary deployment
+  # to make progress before it is rollback (default 60s)
+  progressDeadlineSeconds: 60
   # hpa reference (optional)
   autoscalerRef:
     apiVersion: autoscaling/v2beta1
diff --git a/docs/README.md b/docs/README.md
index 11f869a0..06315b2d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -84,6 +84,9 @@ spec:
     apiVersion: apps/v1
     kind: Deployment
     name: podinfo
+  # the maximum time in seconds for the canary deployment
+  # to make progress before it is rollback (default 60s)
+  progressDeadlineSeconds: 60
   # hpa reference (optional)
   autoscalerRef:
     apiVersion: autoscaling/v2beta1