> 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/analysis-and-prompts/use-the-prompt-library.md).

# Use the prompt library

Create, edit, back up, and reuse scanner prompts.

Open the `BurpGPT Pro` tab and select `Prompt library` to manage saved prompts. Use the search field to find entries, then select a row to edit it or select multiple rows to remove them.

Changes to the library are saved automatically in the current Burp project file and restored when you reopen that project. Use export and import to reuse a library in another project. Provider and scanner settings are saved separately in Burp's user preferences.

{% hint style="warning" %}
In a temporary project, the library lasts only until you close Burp. Export prompts you want to keep before closing it.
{% endhint %}

## Add or edit a prompt

1. Click `Add`, or select one existing prompt and click `Edit`.
2. Enter the `Author`, `Category`, and `Prompt`. All three fields are required.
3. Click `OK` to save.

Scanner prompts can include placeholders such as `{REQUEST}`, `{RESPONSE}`, and `{URL}`. See the [placeholder reference](/analysis-and-prompts/use-placeholder-reference.md) for the complete list.

## Use a prompt for scanning

1. Right-click a prompt in the table.
2. Select `Send to AI scanner`.
3. Open `AI scanner` to review the prompt and message role before scanning.

This action copies the prompt text into the scanner settings. It leaves the message role unchanged and does not start a scan. Later library edits do not update the scanner prompt automatically; send the edited prompt again when you want to use it.

## Remove prompts

Select one or more rows and click `Remove`. Export a backup first if you may need the prompts later.

## Export the library

1. Click `Export`.
2. Choose a destination and save the file with a `.json` extension.

Export includes the entire library, regardless of the current table selection or search filter. You can continue using the interface while the file is saved.

## Import prompts

1. Click `Import`.
2. Select a previously exported JSON file.

Imports merge entries by `id`: an imported entry replaces an existing entry with the same ID. Entries with different IDs are kept, even when their text is identical. If a file contains the same ID more than once, the last entry is used.

A prompt library file is a JSON array. For example:

```json
[
  {
    "id": "efdecb60-64a7-40b1-ab59-cb342d11877b",
    "author": "Security team",
    "category": "authentication",
    "text": "Review this exchange for authentication weaknesses. Cite the evidence and suggest a validation step.\n\nRequest:\n{REQUEST}\n\nResponse:\n{RESPONSE}",
    "created": "2026-10-07T12:00:00Z"
  }
]
```

`author`, `category`, and `text` must contain non-blank values. When omitted, `id` and `created` are generated automatically. Preserve an entry's ID when you want a later import to update it.

## Restore the bundled examples

{% hint style="warning" %}
Resetting replaces the current library with the bundled examples. Export custom prompts first so you can import them again afterwards.
{% endhint %}

Open `Manage global settings` → `Reset to defaults` on the `Prompt library` page. Existing libraries are retained on upgrade, so reset the library if you want the updated 3.1 examples.