From 23fac3a913e3261eddebc78633b5c7b586d96ae7 Mon Sep 17 00:00:00 2001 From: Masakazu Kitajo Date: Fri, 24 Jul 2026 21:04:44 -0600 Subject: [PATCH] doc: clarify run-plugin argument is fixed at load time The run-plugin action's plugin-argument is parsed once when the rule loads, like a remap.config argument, and is never re-evaluated per request, so variable interpolation (e.g. %{HEADER:bar}) does not work there. --- doc/admin-guide/plugins/header_rewrite.en.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/doc/admin-guide/plugins/header_rewrite.en.rst b/doc/admin-guide/plugins/header_rewrite.en.rst index 2d57f64f973..da446873201 100644 --- a/doc/admin-guide/plugins/header_rewrite.en.rst +++ b/doc/admin-guide/plugins/header_rewrite.en.rst @@ -1171,6 +1171,12 @@ run-plugin This allows to run an existing remap plugin, conditionally, from within a header rewrite rule. +.. note:: + ```` is fixed when the rule is loaded (or reloaded); + it behaves the same as a plugin argument in ``remap.config``. It is + not re-evaluated per request, so variable interpolation (e.g. + ``%{HEADER:bar}``) does not work here. + set-body ~~~~~~~~ ::