Skip to content

Guide

Managing prompts

Create, edit, publish, and share prompts in the web app

Learn how to work with prompts in the PromptCache web app.

Create a prompt

  1. Go to Prompts → New prompt.
  2. Enter a name and optional description or tags.
  3. Write your template in Markdown. Add placeholders with double curly braces:
Code
Hi {{customer_name}},
 
Thanks for reaching out about {{issue}}. Here is what we recommend…
  1. Click Save. Variable names are picked up automatically from the template.

Edit the draft

The prompt you see in the editor is the live draft. Every save updates this copy. Your applications read the draft when they invoke a prompt unless you explicitly target a published version.

Tips:

  • Use clear variable names (customer_name, not x).
  • Add descriptions to variables so teammates know what to fill in.
  • Tags help you filter long prompt lists.

Variables

Each {{variable}} can have:

SettingMeaning
TypeText, number, boolean, etc.
RequiredMust be provided when rendering
DefaultUsed when no value is passed

You can adjust these in the variable panel after the template is saved.

Publish a version

When you are happy with the draft, Publish creates a numbered snapshot in version history. Publishing does not lock the draft, you can keep editing and publish again later.

Use publish when you need:

  • A fixed release to reference in reviews or compliance
  • A checkpoint before large changes
  • A version to fork into another workspace

Share and visibility

Prompts can be private (workspace only) or public (listed in the public catalog). Change visibility in prompt settings when your plan allows it.

Use prompts outside the dashboard

MethodBest for
Claude Code (MCP)Editing and rendering prompts while coding with Claude
REST APIBackend services and automation
JavaScript SDKNode.js and browser apps

See Connect Claude Code, Prompts API, or SDK.

Common questions

What is the difference between save and publish?
Save updates the draft only. Publish adds a new row to version history.

Which version does my app use?
By default, invoke uses the current draft. Use version-specific APIs when you need a published snapshot.

Can I undo a bad edit?
Compare against a published version in history, or fork an older version into a new prompt.

Next steps