diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index 9b1fb89024..e86139aa92 100644
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -295,6 +295,14 @@
         that you are affected by that.
       </para>
     </section>
+
+    <section>
+      <title>GdkPixbuf is deemphasized</title>
+      <para>
+        A number of GdkPixbuf-based APIs have been removed. Use the available
+        surface-based replacements instead.
+      </para>
+    </section>
   </section>
 
 </chapter>