diff --git a/docs/system/deprecated.rst b/docs/system/deprecated.rst
index b633fb3ef0..3f8a00e909 100644
--- a/docs/system/deprecated.rst
+++ b/docs/system/deprecated.rst
@@ -408,6 +408,14 @@ The above, converted to the current supported format::
 linux-user mode CPUs
 --------------------
 
+``unicore32`` CPUs (since 5.2.0)
+''''''''''''''''''''''''''''''''
+
+The ``unicore32`` guest CPU support is deprecated and will be removed in
+a future version of QEMU. Support for this CPU was removed from the
+upstream Linux kernel, and there is no available upstream toolchain
+to build binaries for it.
+
 ``tilegx`` CPUs (since 5.1.0)
 '''''''''''''''''''''''''''''