diff --git a/docs/api/core.rst b/docs/api/core.rst
index 70ed598f..f03835e1 100644
--- a/docs/api/core.rst
+++ b/docs/api/core.rst
@@ -146,6 +146,10 @@ Core listener
 Deprecated API features
 =======================
 
+.. warning::
+  Though these features still work, they are slated to go away in the next
+  major Mopidy release.
+
 Core
 ----