diff --git a/doc/Paging.md b/doc/Paging.md
new file mode 100644
index 0000000000000000000000000000000000000000..608ebc0489d35e5e60ff9cb0c5c28846d729a1ca
--- /dev/null
+++ b/doc/Paging.md
@@ -0,0 +1,24 @@
+The Paging flag splits the retrieval of a (possibly huge) number entities into pages.
+
+# Syntax
+
+
+          flag   = name, [":", value];
+          name   = "P";
+          value  = [ index ], ["L", length]];
+          index  =  ? any positive integer ?;
+          length =  ? any positive integer ?;
+
+# Semantics
+
+The `index` (starting with zero) denotes the index of the first entity to be retrieved. The `length` is the number of entities on that page. If `length` is omitted, the default number of entities is returned (as configured by a server constant called ...). If only the `name` is given the paging behaves as if the `index` has been zero.
+
+# Examples
+
+`https://caosdb/Entities/all?flags=P:24L50` returns 50 entities starting with the 25th entity which would be retrieved without paging.
+
+`https://caosdb/Entities/all?flags=P:24` returns the default number of entities starting with the 25th entity which would be retrieved without paging.
+
+`https://caosdb/Entities/all?flags=P:L50` returns 50 entities starting with the first entity which would be retrieved without paging.
+
+`https://caosdb/Entities/all?flags=P` returns the default number of entities starting with the first entity which would be retrieved without paging.
\ No newline at end of file