Manage Prompts

The Prompt Hub list page (/prompt-hub) is where every prompt in your project lives. The header has a Learn more button that links back to these docs, and a Create new button that appears once your database connection is healthy. If you haven’t created a prompt yet, you’ll see a “Get Started with Prompt Hub” screen highlighting four things Prompt Hub gives you: Version Control, Variable Support, Team Collaboration, and Usage Tracking.

​

The prompt list

Each row in the table shows: Clicking anywhere else on a row opens that prompt’s detail page. Deleting a prompt asks you to confirm: “Are you sure you want to delete this prompt?”

​

Creating a prompt

Click Create new to open the create page (/prompt-hub/new). The header has Back and Save Prompt buttons.

• Name - required. As you type, the input is automatically lowercased, spaces become underscores, and any character outside a-z and _ is stripped, matching the hint “(lowercase letters and _ only)”. The name can’t be changed once the prompt is created.
• Prompt content editor - has a hint to “Use {{variableName}} for dynamic variables”, an inline “Improve prompt with Otter” assistant bar above it (see AI Prompt Improvement), and Write / Preview tabs below - Write is a plain text editor with line numbers, and Preview renders your content as Markdown (showing “Nothing to preview yet.” if the editor is empty).
• Version - four cards: Draft, Major, Minor, or Patch. See Versioning for what each one does.
• Tags - add free-form tag chips by pressing Enter or clicking the ”+” button; remove them individually.
• Meta Properties - repeatable Key/Value rows for any metadata you want to attach; add rows with Add property and remove them individually.

Both Name and content are required - you’ll see “Prompt name is required” or “Prompt content is required” if you try to save without them. Saving shows a “Creating prompt…” loading toast, then “Prompt created successfully!” or “Failed to create prompt”. If the name is already taken, saving fails with “Prompt name is already taken!”.

​

Viewing a prompt

The detail page (/prompt-hub/[id]) shows the prompt’s name (with a Draft badge if the version you’re viewing is the draft), its version number, and “Published on ”. Below that: tag badges, the read-only rendered prompt content, and a Meta Properties table if any were set. The action button changes depending on what you’re looking at:

• Publish Version - shown when you’re viewing the draft, and takes you to the edit page to finish and publish it.
• Create New Version - shown when you’re viewing the latest published version and there’s no pending draft, and takes you to the edit page to start a new version from it.

On the right side of the detail page are two tabs: Versions (covered in Versioning) and Rules (covered in Rules). You can also open any past version directly by adding ?version=X to the detail page URL.

​

Editing a prompt

The edit page (/prompt-hub/[id]/edit) has the same layout as the create page, minus the Name field. It loads your current draft if one exists, or otherwise the latest published version as a starting point for a new one. The subheading tells you which mode you’re in:

• “Editing draft - publish when ready” - you’re modifying the existing draft.
• “Creating a new version from the latest published” - you’re starting a new version on top of the latest published one.

The same Draft / Major / Minor / Patch version picker appears here too, except the Draft option reads “No version change” / “Keep as draft - not published” instead of the create page’s wording. The Save button shows “Saving…” while in progress, then “Prompt saved!” on success or “Failed to save prompt.” on failure.

---