diff --git a/developer_manual/app_publishing_maintenance/upgrade-guide.rst b/developer_manual/app_publishing_maintenance/upgrade-guide.rst
index 7b0bba9e8aa..75e981d4965 100644
--- a/developer_manual/app_publishing_maintenance/upgrade-guide.rst
+++ b/developer_manual/app_publishing_maintenance/upgrade-guide.rst
@@ -34,6 +34,12 @@ Removed globals
 
 * ``escape-html``: use `the escape-html package <https://www.npmjs.com/package/escape-html>` or similar
 
+Deprecated global variables
+***************************
+
+* ``humanFileSize``: use ``formatfilesize`` from https://www.npmjs.com/package/@nextcloud/files
+* ``OC.getCanonicalLocale``: use ``getCanonicalLocale`` from https://www.npmjs.com/package/@nextcloud/l10n
+
 Removed jQuery plugins
 **********************