diff --git a/docs/simplesamlphp-upgrade-notes-2.0.md b/docs/simplesamlphp-upgrade-notes-2.0.md
index ff3b6accc50ca18760e118cf5365b15f3e75edd1..003efea78c87f7ef33915b08468e7a4313b3e7bd 100644
--- a/docs/simplesamlphp-upgrade-notes-2.0.md
+++ b/docs/simplesamlphp-upgrade-notes-2.0.md
@@ -32,7 +32,10 @@ Functional changes
 - All support for the Shibboleth 1.3 / SAML 1.1 protocol has been removed.
 - Sessions are no longer backwards compatible with previous versions. Make sure to clear your session cache during
   the upgrade process. How to do this depends on your session backend.
-- EntityIDs are no longer auto-generated. Make sure to set it to something sensible in the array-keys in `metadata/saml20-idp-hosted.php` (or to the existing entityID when upgrading an existing installation).
+- EntityIDs are no longer auto-generated. Make sure to set it to something sensible in the array-keys in
+  `metadata/saml20-idp-hosted.php` (or to the existing entityID when upgrading an existing installation).
+  If you are using a database to store metadata, make sure to replace any __DYNAMIC% entityID's with
+  a real value manually. Dynamic records are no longer loaded from the database.
 
 Configuration changes
 ---------------------