From d0cd6fa1ee942226dd42ef77fdc54f619173514e Mon Sep 17 00:00:00 2001 From: mscherer Date: Mon, 12 Jan 2026 08:23:01 +0100 Subject: [PATCH] Document preserveQuery in limitControl --- en/views/helpers/paginator.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/en/views/helpers/paginator.rst b/en/views/helpers/paginator.rst index d1c114393f..4ea6a474fb 100644 --- a/en/views/helpers/paginator.rst +++ b/en/views/helpers/paginator.rst @@ -430,6 +430,13 @@ Create a dropdown control that changes the ``limit`` query parameter:: The generated form and control will automatically submit on change. +By default ``limitControl()`` preserves existing query parameters as hidden +fields. You can control this behavior with the ``preserveQuery`` option: + +* ``true`` Keep all query parameters (default). +* ``false`` Do not include any preserved query parameters. +* ``array`` Only keep the listed top-level keys. + Automatic Limit Generation with Steps --------------------------------------