Prompt Management
LibreChat’s prompt management system allows you to create reusable prompt templates with variables, manage versions, organize prompts into groups, and quickly access them during conversations.Overview
Prompts in LibreChat are organized into Prompt Groups, with each group containing:- Multiple prompt versions - Track iterations and changes
- Variables - Placeholders for dynamic content
- Metadata - Category, description, and command shortcuts
- Production version - The current “live” version for quick access
Accessing Prompts
Navigate to the Prompts section from your dashboard to view, create, and manage prompt groups.Prompt Groups List
The main prompts view displays:- All your prompt groups organized by category
- Quick preview of each prompt
- Filtering and search capabilities
- Options to create new prompt groups
Prompt Editor Modes
LibreChat offers two editing modes:Simple Mode
Focused interface showing:- Single prompt editor
- Basic metadata (name, description, command)
- Variable management
- Category selection
Advanced Mode
Full-featured interface with:- Version history and management
- Production version selection
- All versions visible in sidebar
- Advanced versioning controls
Creating Prompts
Creating a New Prompt Group
- Navigate to the Prompts section
- Click Create New Prompt or similar action button
- The prompt editor opens with empty fields
-
Fill in the prompt details:
- Name - A descriptive title for your prompt group
- Category - Organize prompts by type or purpose
- Description - Brief explanation of what the prompt does
- Command - Optional slash command shortcut (e.g.,
/analyze) - Prompt Text - The actual prompt content
- Add variables if needed (see Variables section below)
- Click outside the editor or navigate away to auto-save
Prompt Name
The prompt name appears in lists and is editable inline:- Click on the prompt name in the editor header
- Edit the text
- Press Enter or click away to save
Prompt Editor
Writing Prompts
The main editor is a rich text area where you write your prompt content:- Markdown supported - Format with headers, lists, code blocks, etc.
- Variable syntax - Use
{{variableName}}for placeholders - Multi-line - Write detailed, structured prompts
- Auto-save - Changes save automatically when you stop editing
Prompt Description
Add a description to explain:- Purpose of the prompt
- Best use cases
- Expected inputs or outputs
- Any special instructions
Command Shortcuts
Assign a command to invoke your prompt quickly:- Enter a command in the Command field (e.g.,
analyze,summarize) - In conversations, type
/followed by your command - The prompt is inserted with placeholders for variables
Variables
Variables are placeholders in your prompts that can be filled with dynamic content.Adding Variables
- In your prompt text, use double curly braces:
{{variableName}} - LibreChat automatically detects variables in your prompt
- The Variables section displays all detected variables
- Click on a variable to edit its properties
Variable Configuration
For each variable, you can set:- Name - The identifier used in the prompt (
{{name}}) - Label - Display name shown to users
- Type - Text, number, or other input types
- Default Value - Pre-filled value when the prompt is used
- Required - Whether the variable must be filled
Using Variables in Prompts
Example prompt with variables:- A dialog appears with fields for each variable
- Fill in the values
- The prompt is inserted with variables replaced
Variable Best Practices
- Use descriptive names -
{{userGoal}}vs{{var1}} - Provide defaults - Helpful starting points for common values
- Mark required fields - Prevent incomplete prompt submissions
- Limit variables - Too many makes prompts cumbersome (aim for 3-7)
Prompt Versions
Creating New Versions
Every time you edit and save a prompt, a new version is created:- Make changes to your prompt text
- The changes auto-save
- A new version appears in the versions list (Advanced Mode)
Version History
In Advanced Mode, the right sidebar shows:- All versions of the current prompt group
- Each version’s timestamp
- The production version indicator
- Options to select different versions
Viewing Different Versions
- Switch to Advanced Mode if needed
- In the versions sidebar, click on any version
- The editor loads that version’s content
- You can view, edit, or set it as production
Setting Production Version
The production version is the “official” current version:- Open the prompt in Advanced Mode
- Select the version you want to make production
- Click the rocket icon (Make Production button)
- The version is now marked as production
Deleting Versions
- Select the version you want to delete
- Click the delete button
- Confirm the deletion
Categories
Organize your prompts with categories for easier navigation and filtering.Selecting a Category
- In the prompt editor, find the Category Selector (usually in the header or sidebar)
- Click to open the category dropdown
- Select a category from the list
- The prompt group is automatically recategorized
Available Categories
Common categories include:- Writing - Content creation, copywriting, creative writing
- Code - Programming, debugging, code review
- Analysis - Data analysis, research, evaluation
- Education - Learning, tutoring, explanations
- Business - Strategy, planning, reporting
- Custom - Create your own categories
Category Icons
Each category has an associated icon for visual identification in lists and views.Sharing Prompts
Share prompt groups with team members or the community (if your instance has sharing enabled).How to Share a Prompt
- Open the prompt you want to share
- Click the Share button in the editor header
- Configure sharing options:
- Share with specific users
- Share with groups
- Make publicly accessible
- Generate a share link or send invitations
- Recipients can view and optionally import your prompt
Shared Prompt Permissions
When you share a prompt, you can grant:- View only - Others can see but not edit
- Edit - Collaborators can modify the prompt
- Share - Recipients can share with others
Importing Shared Prompts
- Open a shared prompt link
- Review the prompt content
- Click Import or Add to My Prompts
- The prompt is copied to your prompt library
- You can edit your copy independently
Using Prompts in Conversations
Inserting Prompts via Command
- In any conversation, type
/ - Start typing your command name
- Select the prompt from the autocomplete list
- If the prompt has variables, a dialog appears
- Fill in the variable values
- Click Insert to add the prompt to your message
Quick Access from Prompt List
- Navigate to Prompts section
- Click on a prompt to preview
- Click Use in Chat or similar action
- A new conversation opens with the prompt ready
Auto-Send Prompts
Configure prompts to auto-send immediately after variable input:- Edit the prompt settings
- Enable Auto-send option
- When you use the prompt and fill variables, it sends automatically
Advanced Features
Always Make Production
Enable this setting to automatically set new versions as production:- Open prompt group settings
- Toggle Always Make Production
- Every new save becomes the production version immediately
Prompt Templates
Create templates for common prompt structures:- Design a prompt with placeholder structure
- Use descriptive variables for all customizable parts
- Save with a template-like name (e.g., “[Template] Analysis Framework”)
- Duplicate and modify for specific use cases
Admin Settings (For Admins)
Administrators can:- Set global prompt access policies
- Create organization-wide prompt libraries
- Manage sharing permissions
- Configure default categories
Managing Your Prompts
Organizing Prompts
- Use categories consistently - Helps with filtering and discovery
- Name clearly - Prompt names should indicate purpose
- Archive unused prompts - Keep your active list focused
- Document complex prompts - Add detailed descriptions
Prompt Maintenance
- Review periodically - Update prompts as best practices evolve
- Test variations - Use versions to A/B test different approaches
- Gather feedback - Note which prompts work well
- Clean up versions - Delete experimental or broken versions
Filtering Prompts
Use the filter controls in the prompts list:- Filter by category
- Search by name or content
- Sort by created date, updated date, or name
- Show only your prompts or shared prompts
Tips and Best Practices
Writing Effective Prompts
- Be specific - Clear instructions yield better results
- Structure with sections - Use headers and lists for complex prompts
- Provide context - Include background information when needed
- Use examples - Show the AI what you’re looking for
- Iterate - Test and refine prompts over time
Variable Design
- Logical grouping - Related variables should flow naturally
- Clear labels - Users should understand what to input
- Sensible defaults - Save time with common values pre-filled
- Validation - Mark required fields appropriately
Version Control
- Meaningful changes - Don’t create versions for trivial edits
- Production discipline - Only promote well-tested versions
- Keep history - Versions show evolution of your prompt
- Document major versions - Note what changed in descriptions
Troubleshooting
Prompt Not Saving
- Check your internet connection
- Verify you have edit permissions
- Try refreshing the page and re-entering changes
Variables Not Detected
- Ensure you’re using double curly braces:
{{variable}} - Check for typos in variable names
- Variables should be one word or use underscores:
{{my_variable}}
Command Not Working
- Verify the command is set in prompt settings
- Commands should be unique (no duplicates)
- Try typing the full command name
- Check that the prompt is saved and production version is set
Can’t Share Prompt
- Sharing may be disabled by your administrator
- You may not have share permissions for this prompt
- Check that you’re the owner or have been granted share rights
Keyboard Accessibility
Prompt management is fully keyboard accessible:- Tab - Navigate between fields and controls
- Enter - Save inline edits, confirm actions
- Escape - Cancel edits, close dialogs
- Arrow keys - Navigate lists and dropdowns