diff --git a/lib/upgrade.txt b/lib/upgrade.txt
index 47907a3eaf0..06b25b09b27 100644
--- a/lib/upgrade.txt
+++ b/lib/upgrade.txt
@@ -22,6 +22,8 @@ information provided here is intended especially for developers.
   now relies on the main config.php when deploying an available update.
 * sql_internal_reader and sql_select_reader interfaces have been deprecated in favour of sql_internal_table_reader
   and sql_reader which use iterators to be more memory efficient.
+* $CFG->enabletgzbackups setting has been removed as now backups are stored internally using .tar.gz format by default, you can
+  set $CFG->usezipbackups to store them in zip format. This does not affect the restore process, which continues accepting both.
 
 === 2.8 ===