Conversation Management

Organize, search, bookmark, and share your conversations in LibreChat

Overview

LibreChat provides powerful tools to manage your conversation history, including search, bookmarks, tags, sharing, and organization features. Keep your conversations organized and easily accessible.

Conversation List

The sidebar displays your conversation history:

• Recent conversations: Sorted by last activity
• Conversation titles: Auto-generated or custom
• Conversation metadata: Model, date, message count
• Search bar: Quick filtering by title or content

Creating Conversations

1. Start New Chat

   Click New Chat in the sidebar or header.

2. Select Configuration

   Choose:

   • Model and endpoint
   • Preset (optional)
   • Agent (optional)
3. Begin Conversation

   Send your first message. The conversation title is auto-generated based on content.

Conversation Titles

Auto-Generated Titles

By default, titles are automatically generated from conversation content:

# librechat.yaml
# TITLE_CONVO=true (default)

Title Generation Configuration

Control which model generates titles:

# .env
OPENAI_TITLE_MODEL=gpt-4o-mini

Or in librechat.yaml per endpoint:

endpoints:
  custom:
    - name: 'Mistral'
      titleModel: 'mistral-tiny'
      titleConvo: true

Manual Rename

1. Hover Over Conversation

   In the sidebar, hover over the conversation you want to rename.

2. Click Options

   Click the three-dot menu icon.

3. Select Rename

   Choose Rename and enter a new title.

Searching Conversations

LibreChat includes powerful search capabilities:

Quick Search

Use the search bar in the sidebar:

1. Type your search query
2. Results filter in real-time
3. Search includes titles and content

MeiliSearch (Advanced)

For large conversation histories, enable MeiliSearch:

# .env
SEARCH=true
MEILI_HOST=http://0.0.0.0:7700
MEILI_MASTER_KEY=your-secure-key
MEILI_NO_ANALYTICS=true

# docker-compose.yml
meilisearch:
  image: getmeili/meilisearch:v1.6
  ports:
    - "7700:7700"
  environment:
    - MEILI_MASTER_KEY=${MEILI_MASTER_KEY}
  volumes:
    - meili_data:/meili_data

MeiliSearch provides lightning-fast full-text search across all your conversations, even with thousands of messages.

Bookmarks

Save important conversations for quick access:

1. Open Conversation Options

   Hover over a conversation and click the three-dot menu.

2. Bookmark

   Click Add to Bookmarks.

3. Access Bookmarks

   View all bookmarks in the dedicated Bookmarks section of the sidebar.

Bookmark Configuration

# librechat.yaml
interface:
  bookmarks: true  # Enable bookmarks

Managing Bookmarks

• Edit: Modify bookmark tags or notes
• Remove: Unbookmark a conversation
• Search: Filter bookmarks by tag or title

Tags

Organize conversations with custom tags:

// Tag examples
{
  tags: ['work', 'project-alpha'],
  conversation_id: 'conv-123'
}

Tags are user-specific and help you categorize conversations by project, topic, or priority.

Sharing Conversations

Share conversations with other users or publicly:

1. Enable Sharing

   Ensure sharing is enabled:

   # librechat.yaml
   interface:
     # Private sharing with specific users
     peoplePicker:
       users: true
       groups: true
       roles: true
   
2. Share a Conversation

   1. Open conversation options menu
   2. Click Share
   3. Select users, groups, or roles
   4. Choose permissions (view/edit)
3. Manage Shared Access

   View and modify sharing settings from the conversation options.

Shared Links

Create public links to conversations:

# librechat.yaml
interface:
  # Enable shared links
  fileCitations: true

# .env
ALLOW_SHARED_LINKS=true
ALLOW_SHARED_LINKS_PUBLIC=true

Public shared links allow anyone with the URL to view the conversation. Use with caution for sensitive information.

Conversation Options

Right-click or click the three-dot menu on any conversation:

Available Actions

• Rename: Change conversation title
• Delete: Permanently remove conversation
• Archive: Hide from main list (if enabled)
• Bookmark: Add to bookmarks
• Share: Share with users or create public link
• Fork: Create a branch from a specific message
• Export: Download conversation data

Deleting Conversations

1. Select Conversation

   Hover over the conversation you want to delete.

2. Open Options Menu

   Click the three-dot icon.

3. Confirm Deletion

   Click Delete and confirm the action.

Deleted conversations cannot be recovered. Export important conversations before deleting.

Multi-Conversation Mode

Manage multiple conversations simultaneously:

# librechat.yaml
interface:
  multiConvo: true

With multi-conversation mode:

• Open multiple chat windows
• Switch between conversations quickly
• Compare responses across different models

Conversation Export

Export conversations for backup or analysis:

Single Conversation

1. Open conversation options
2. Select Export
3. Choose format (JSON, Markdown, etc.)
4. Download file

Bulk Export

Use the bulk actions menu to export multiple conversations at once.

Export Rate Limiting

# librechat.yaml
rateLimits:
  conversationsImport:
    ipMax: 100
    ipWindowInMinutes: 60
    userMax: 50
    userWindowInMinutes: 60

Conversation Import

Import conversations from other systems:

# .env
# Limit import file size (bytes)
CONVERSATION_IMPORT_MAX_FILE_SIZE_BYTES=262144000  # 250 MB

Supported formats depend on the import feature configuration. Typically includes JSON exports from LibreChat or compatible systems.

Temporary Conversations

Configure automatic cleanup of old conversations:

# librechat.yaml
interface:
  # Retention period in hours (default: 720 = 30 days)
  temporaryChatRetention: 720

Temporary conversations are automatically deleted after the retention period. Bookmarked conversations are exempt from automatic deletion.

Pagination

For users with many conversations:

// Conversations are paginated for performance
{
  pageNumber: 1,
  pageSize: 20,
  totalPages: 15
}

Navigate pages using the pagination controls at the bottom of the conversation list.

Configuration Reference

# librechat.yaml
interface:
  bookmarks: true
  multiConvo: true
  fileCitations: true
  temporaryChatRetention: 720  # hours
  
  peoplePicker:
    users: true
    groups: true
    roles: true

# Search configuration
search:
  enabled: true  # Implicit via SEARCH=true in .env

# Rate limits
rateLimits:
  conversationsImport:
    ipMax: 100
    ipWindowInMinutes: 60
    userMax: 50
    userWindowInMinutes: 60

# .env
SEARCH=true
MEILI_HOST=http://0.0.0.0:7700
MEILI_MASTER_KEY=your-key
MEILI_NO_ANALYTICS=true
# MEILI_NO_SYNC=true  # Disable indexing in multi-node setups

ALLOW_SHARED_LINKS=true
ALLOW_SHARED_LINKS_PUBLIC=true

CONVERSATION_IMPORT_MAX_FILE_SIZE_BYTES=262144000

Best Practices

• Regular cleanup: Delete or archive old conversations
• Meaningful titles: Rename important conversations
• Use bookmarks: Mark conversations you’ll reference frequently
• Tag consistently: Develop a tagging system that works for you
• Export regularly: Back up important conversations
• Share selectively: Only share conversations with necessary recipients

Troubleshooting

Search not working

• Verify MeiliSearch is running (docker ps)
• Check SEARCH=true in .env
• Ensure MEILI_HOST is accessible
• Check MeiliSearch logs for errors

Conversations not loading

• Check MongoDB connection
• Verify sufficient server resources
• Clear browser cache
• Check for JavaScript errors in console

Sharing not available

• Ensure peoplePicker is configured
• Check user permissions
• Verify authentication is working

Auto-titles not generating

• Check TITLE_CONVO is enabled
• Verify OPENAI_TITLE_MODEL or equivalent is configured
• Ensure model has API access
• Check for rate limiting

Related Features

• Presets
• Agents