diff --git a/doc/source/misc/carbons.rst b/doc/source/misc/carbons.rst
new file mode 100644
index 00000000..7b2dcadf
--- /dev/null
+++ b/doc/source/misc/carbons.rst
@@ -0,0 +1,17 @@
+Message Carbons
+===============
+
+Starting from poezio 0.8, poezo now supports `message carbons`_.
+
+Message carbons are useful to duplicate chat messages between several
+connected devices, so that when you switch from one to another, you
+don’t lose any message you sent or received.
+
+To enable it, you only have to set the :term:`enable_carbons` option to ``true``.
+
+.. note::
+
+    This feature only duplicates *chat* messages (direct conversations between
+    two JIDs), not groupchat messages or private conversations in groupchats.
+
+.. _message carbons: http://xmpp.org/extensions/xep-0280.html
diff --git a/doc/source/misc/index.rst b/doc/source/misc/index.rst
index be6f12c3..713459de 100644
--- a/doc/source/misc/index.rst
+++ b/doc/source/misc/index.rst
@@ -6,7 +6,8 @@ Contents:
 .. toctree::
     :maxdepth: 2
 
-    separate
+    carbons
     correct
+    separate
     ssl