diff --git a/reference/install.md b/reference/install.md
index c9d656a812..27626056a3 100644
--- a/reference/install.md
+++ b/reference/install.md
@@ -64,4 +64,5 @@ mounting the file at `/docker_subscription.lic` in the tool.
 | `--preserve-certs`                                         | Don't (re)generate certs on the host if existing ones are found.                               |
 | `--binpack`                                                | Set Swarm scheduler to binpack mode (default spread).                                          |
 | `--random`                                                 | Set Swarm scheduler to random mode (default spread).                                           |
-| `--pull "missing"`                                         | Specify image pull behavior (`always`, when `missing`, or `never`).                            |
+| `--pull "missing"`                                         | Specify image pull behavior (`always`, when `missing`, or `never`).                            
+| `--swarm-experimental`                                    | Enable experimental Swarm features (e.g. container rescheduling). Note: Use only for install, not join). |
diff --git a/release_notes.md b/release_notes.md
index 80813e4435..1c67e6fd57 100644
--- a/release_notes.md
+++ b/release_notes.md
@@ -21,6 +21,7 @@ weight="99"
   * Upgraded Swarm to 1.1.3
   * Improved support for `docker cp`
   * System CA pool fallback for secure DTR connections
+  * Added `--swarm-experimental` option during UCP install
 
 * UI
   * Added checkbox to select all containers in Containers screen