From 92c87b7ff4d7ffca2f9520c5ec43f3f87747c00c 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 058c62de9a..c50ca26647 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. + Configuring Pagination Options ==============================