> For the complete documentation index, see [llms.txt](https://docs.burpgpt.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.burpgpt.app/how-to/use-placeholder-reference.md).

# Use placeholder reference

Placeholders let scan prompts include specific parts of the HTTP request and response being analysed. The extension replaces supported placeholders before sending the final prompt to the configured model provider.

Use placeholders in `AI scanner` prompt templates and prompt library entries that you send to the scanner settings.

## View supported placeholders

To view the supported placeholders in Burp Suite:

1. Go to the `BurpGPT Pro` tab.
2. Select `Placeholder reference`.
3. Use the search field to find a placeholder by name or description.

## Supported placeholders

| Placeholder          | Value                                                |
| -------------------- | ---------------------------------------------------- |
| `{REQUEST}`          | The full scanned request.                            |
| `{URL}`              | The URL of the scanned request.                      |
| `{METHOD}`           | The HTTP request method used in the scanned request. |
| `{REQUEST_HEADERS}`  | The headers of the scanned request.                  |
| `{REQUEST_BODY}`     | The body of the scanned request.                     |
| `{RESPONSE}`         | The full scanned response.                           |
| `{RESPONSE_HEADERS}` | The headers of the scanned response.                 |
| `{RESPONSE_BODY}`    | The body of the scanned response.                    |

## Example

```
Analyse the following HTTP exchange for security issues.

Method: {METHOD}
URL: {URL}

Request:
{REQUEST}

Response:
{RESPONSE}
```

Use narrower placeholders when you only need part of the traffic. For example, use `{REQUEST_HEADERS}` when you want the model to focus on authentication, cookies, or custom headers.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.burpgpt.app/how-to/use-placeholder-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.