> ## Documentation Index
> Fetch the complete documentation index at: https://www.pagent.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Flags

> Runtime 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:

```text theme={"dark"}
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

| Flag                            | Default | Purpose                                                                                                                                          |
| ------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| `pagent_disable_variation`      | `false` | Disables **all** experiments and always shows the original view. Useful when you want to compare performance or rule out Pagent as a root cause. |
| `pagent_debug`                  | `false` | Enables verbose console logging prefixed with `[pagent]`. Example: `[pagent] Pagent init completed in 129 ms`                                    |
| `pagent_force_variation`        | `false` | Forces the **test** variation for every experiment, bypassing normal assignment logic.                                                           |
| `pagent_force_control`          | `false` | Forces 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.                                                 |