# Chat History Management

Every conversation in Qolaba is automatically saved to your workspace history. The three-dot menu **(⋮)** on any chat thread gives you full control over how conversations are organized, shared, and maintained — keeping your workspace clean and easy to navigate.

***

### Viewing Chat History

All conversations are saved automatically in **reverse chronological order** — most recent at the top. Pinned chats remain fixed at the top of the list regardless of newer activity below them.

***

### Searching Chat History

Use the **search bar** in the chat history panel to quickly locate any past conversation. You can search by chat title, keywords from your prompts, or keywords from AI responses. Results filter automatically as you type.

***

### Managing Chats

Hover over any chat in your history panel and click the **⋮ menu** to the right of the chat title to access all management actions.

***

#### **Pin Chat**

Pinning keeps a conversation fixed at the top of your history list, regardless of how many new chats are created after it. Use this for active projects, ongoing client work, threads with finalized outputs, or conversations containing prompts you return to regularly.

{% hint style="info" %}
**Best practice:** Pin only active or high-priority threads. Over-pinning reduces the benefit and clutters your history panel.
{% endhint %}

***

#### **Rename Chat**

Chat titles are auto-generated from your first prompt — which is rarely descriptive enough for a growing history. Renaming makes your conversations scannable, searchable, and easier to share with teammates.

**To rename a chat:**

1. Click the **⋮ menu** on the chat
2. Select **Rename Chat**
3. Enter a clear, descriptive title
4. Save

**Naming conventions that work well:**

* `Client A – Blog Draft`
* `Product Launch – Ad Copy`
* `GPT vs Claude – Benchmark Test`
* `Internal Strategy – Q2 Planning`

Good naming improves searchability, workspace organization, and collaboration — especially in shared workspaces with multiple team members.

***

#### **Share Chat**

Share Chat generates a **read-only link** to a snapshot of the conversation. This is useful for client approvals, internal reviews, handoffs, or documentation.

**To generate a shareable link:**

1. Click the **⋮ menu** on the chat
2. Select **Share Chat**
3. Copy the generated link and distribute it

The recipient can view the conversation content but cannot edit it, access workspace settings, or interact with your credits. Only the conversation itself is shared.

**To revoke access:**

1. Return to **Share Chat** on the same thread
2. Select **Revoke Link**

The link becomes invalid immediately — giving you full control over external visibility and client-specific access.

***

#### **Delete Chat**

Deleting a chat permanently removes it from your workspace history. Use this to clear outdated drafts, test prompts, failed experiments, or irrelevant threads.

{% hint style="info" %}
Once deleted, the conversation cannot be recovered. Credits already consumed during that session are not refunded.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qolaba.ai/chatbot/chat-history-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
