diff --git a/roles/matrix/templates/matrix-synapse/homeserver.yaml.j2 b/roles/matrix/templates/matrix-synapse/homeserver.yaml.j2
index fb100f3..930260f 100644
--- a/roles/matrix/templates/matrix-synapse/homeserver.yaml.j2
+++ b/roles/matrix/templates/matrix-synapse/homeserver.yaml.j2
@@ -2776,3 +2776,30 @@ background_updates:
     # Uncomment and set a size to change the default.
     #
     #default_batch_size: 50
+
+
+## media_retention ##
+
+# Controls whether local media and entries in the remote media cache (media that is downloaded from other homeservers)
+# should be removed under certain conditions, typically for the purpose of saving space.
+# Purging media files will be the carried out by the media worker (that is, the worker that has the enable_media_repo
+# homeserver config option set to 'true'). This may be the main process.
+# The media_retention.local_media_lifetime and media_retention.remote_media_lifetime config options control whether
+# media will be purged if it has not been accessed in a given amount of time. Note that media is 'accessed' when loaded
+# in a room in a client, or otherwise downloaded by a local or remote user. If the media has never been accessed, the
+# media's creation time is used instead. Both thumbnails and the original media will be removed. If either of these
+# options are unset, then media of that type will not be purged.
+# Local or cached remote media that has been quarantined will not be deleted. Similarly, local media that has been
+# marked as protected from quarantine will not be deleted.
+#
+media_retention:
+    local_media_lifetime: 90d
+    remote_media_lifetime: 14d
+
+
+## forgotten_room_retention_period ##
+
+# How long to keep locally forgotten rooms before purging them from the DB.
+# Defaults to null, meaning it's disabled.
+#
+forgotten_room_retention_period: 28d