diff --git a/‎docs/api-usage.rst‎
Lines changed: 7 additions & 0 deletions b/‎docs/api-usage.rst‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎docs/cli.rst‎
Lines changed: 4 additions & 0 deletions b/‎docs/cli.rst‎
Lines changed: 4 additions & 0 deletions
@@ -189,6 +189,13 @@ parameter to get all the items when using listing methods:
    all_groups = gl.groups.list(all=True)
    all_owned_projects = gl.projects.owned(all=True)
 
+You can define the ``per_page`` value globally to avoid passing it to every
+``list()`` method call:
+
+.. code-block:: python
+
+   gl = gitlab.Gitlab(url, token, per_page=50)
+
 ``list()`` methods can also return a generator object which will handle the
 next calls to the API when required. This is the recommended way to iterate
 through a large number of items:
 
@@ -71,6 +71,10 @@ parameters. You can override the values in each GitLab server section.
    * - ``api_version``
      - ``3`` ou ``4``
      - The API version to use to make queries. Requires python-gitlab >= 1.3.0.
+   * - ``per_page``
+     - Integer between 1 and 100
+     - The number of items to return in listing queries. GitLab limits the
+       value at 100.
 
 You must define the ``url`` in each GitLab server section.