diff --git a/docs/usage/upgrade_guide.md b/docs/usage/upgrade_guide.md
index 630358f27d847bf0148a6928954b8db34cac0d5e..806c0308c09f244d8c574c7a65fef2053dfe36a2 100644
--- a/docs/usage/upgrade_guide.md
+++ b/docs/usage/upgrade_guide.md
@@ -1,4 +1,6 @@
-# New Changes
+# Upgrade Guide
+
+This guide is intended to help users upgrading from older versions with the recent changes.
 
 ## Autocomplete
 
@@ -31,6 +33,12 @@ in their realname field.
 Avatars can be configured to be square or round, and additionally, you can disable the avatars in the message list as
 well.
 
+## Chat Layout
+
+The new default chat layout shows nicks in a separate row, groups messages from the same user, and shows avatars.
+
+To return to the previous layout, you can disable "Show Avatars", "Separate Nicknames" and "Right-Aligned Timestamps".
+
 ## Highlights & Unread Activity
 
 In Quassel 0.13, highlights and unread activity are managed by the core. This means you won’t ever miss a highlight.