diff --git a/README.md b/README.md
index 6102085..1b4bd3a 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,8 @@ This is meant to be used as a [Drone plugin](http://plugins.drone.io/).
 
 ### Dangerous options, unwise outside CI
 
+- **secrets**: (default: `{}`): names of secrets to generate and store in the
+  swarm. This field is used in conjuction with `generate_secrets` (see below).
 - **generate_secrets** (default: `false`): randomly set all `secrets:` found in the
   compose file -- you won't be able to retrieve them afterwards, so you almost
   certainly don't want this for real deployments.