diff --git a/data/org.gnome.shell.gschema.xml.in b/data/org.gnome.shell.gschema.xml.in
index 49d38d766..6eacfa568 100644
--- a/data/org.gnome.shell.gschema.xml.in
+++ b/data/org.gnome.shell.gschema.xml.in
@@ -109,6 +109,17 @@
the shell.
+
+ []
+ Layout of the app picker
+
+ Layout of the app picker. Each entry in the array is a page. Pages are
+ stored in the order they appear in GNOME Shell. Each page contains an
+ “application id” → 'data' pair. Currently, the following values are
+ stored as 'data':
+ • “position”: the position of the application icon in the page
+
+