Flags

Pagent provides a set of runtime flags that can be appended to the page URL while you are developing, debugging, or testing your site. The SDK reads these flags once during startup, so a simple page refresh is enough to apply them.

How to use

Append one or more flags as query parameters:

https://www.example.com/?pagent_debug=1&pagent_force_variation=1

You can use 1, true, or leave the value empty (e.g. ?pagent_debug) to turn a flag on. Any other value (including 0 or false) turns it off.

Note that flags are not persisted—once you navigate away or reload without them they disappear.

Available flags

FlagDefaultPurpose
pagent_disable_variationfalseDisables all experiments and always shows the original view. Useful when you want to compare performance or rule out Pagent as a root cause.
pagent_debugfalseEnables verbose console logging prefixed with [pagent]. Example: [pagent] Pagent init completed in 129 ms
pagent_force_variationfalseForces the test variation for every experiment, bypassing normal assignment logic.
pagent_force_controlfalseForces the control variation for every experiment.
pagent_preview_variation=<id>Renders the variation with the given ID without publishing it. Mostly used by the visual editor.