# Edit a prompt and save a version

**Category:** [Prompt Manager](https://help.totalctrl.app/hc/totalctrl/totalctrl-help-center/en-US/categories/prompts)
**Updated:** 2026-08-19

## Add a prompt

- Open a library and click **New prompt**.
- Give it a **Name**, an optional description, and pick a **Type** — `text` for a single template or `chat` for message-style prompts.
- Save. The prompt is created and you land in the editor to add your first version.

## Write the body and save a version

In the editor, write the prompt body. Use `{{variable_name}}` placeholders anywhere you want to inject values at runtime — Prompt Manager detects these automatically and records them as the version's variables. You can also choose a **model** from your account's LLM profiles and set model parameters.

Add an optional **commit message** describing the change, then save. This creates a new **numbered version**:

- Versions are **immutable** — each save creates the next number (v1, v2, v3…) and never overwrites an earlier one.
- The newest version becomes the prompt's current version automatically.
- A rough token estimate is stored for each version.

## Review history

The prompt detail page lists every version newest-first, along with any labels pointing to them. Open a version to see its full body, variables, commit message, and any eval runs. You can **pin** a version to flag it as notable. To make a version your live release, move a label to it — see [Promote a version with labels](promote-a-version-with-labels).

---

## Related Articles

- [Prompts Manager Overview](https://help.totalctrl.app/en-US/articles/prompts-manager-overview)
- [Test a prompt with evaluations](https://help.totalctrl.app/en-US/articles/test-a-prompt-with-evaluations)
- [Build a test dataset](https://help.totalctrl.app/en-US/articles/build-a-test-dataset)
- [Promote a version with labels](https://help.totalctrl.app/en-US/articles/promote-a-version-with-labels)
- [GitHub Sync](https://help.totalctrl.app/en-US/articles/github-sync)

---
[← Back to TotalCtrl Help Center](https://help.totalctrl.app/en-US/)