diff --git a/configuration/secrets.rst b/configuration/secrets.rst
index 79d0071fde3..c1a342e9b72 100644
--- a/configuration/secrets.rst
+++ b/configuration/secrets.rst
@@ -98,6 +98,10 @@ in ``config/secrets/prod``. You can also set the secret in a few other ways:
     # or let Symfony generate a random value for you
     $ php bin/console secrets:set REMEMBER_ME --random
 
+.. note::
+
+    If you need to rename a secret, you must create the new one and remove the old one.
+
 Referencing Secrets in Configuration Files
 ------------------------------------------