> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qontext.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing files via the UI

> View, create, edit, and review retrieval logs for files in Qontext

## Overview

A file in Qontext is a structured context object inside your context repository. It captures normalized, shared context about one core entity, for example a customer, product, project, process, or deal.

Files are versioned, governed, and continuously updated from connected sources. They can reference source objects and link to related files. Therefore, agents can follow entity, temporal, semantic, and causal relationships across your context repository.

***

## Viewing files

Files are available in the **Context** tab.

The context repository is shown as a folder tree. Selecting a file renders its Markdown content in the detail panel.

### Relationships and links

Files are connected through explicit references between entities, facts, and source objects. This enables:

* **Targeted context:** Load the most relevant file first, then follow links only when more context is needed.
* **Graph traversal:** Follow entity, temporal, semantic, and causal relationships across files.
* **Single source of truth:** Update context once and reuse it across clients, APIs, and workflows without duplicate copies.

### Retrieval history

Each file includes retrieval logs showing when it was accessed and how.

<Info>
  Logs are scoped to the selected file and include access types such as listed or read. This helps you see what an AI agent accessed, trace outputs back to specific context, and identify the most impactful files on AI responses.
</Info>

***

## Creating files

<Steps>
  <Step title="Add a new file">
    In the **Context** tab, hover over the folder where you want the file to live, open its menu by clicking on the three dots, and select **New file**.

    <img src="https://mintcdn.com/qontext/GFZ9fVfZmIXg9EJQ/images/Qontext-new-file.png?fit=max&auto=format&n=GFZ9fVfZmIXg9EJQ&q=85&s=0283fa25e7752e2fb63edcb259f858db" alt="Qontext New File" title="Qontext New File" style={{ width:"81%" }} width="1356" height="672" data-path="images/Qontext-new-file.png" />
  </Step>

  <Step title="Rename it">
    The new file opens in the editor. Rename it and add your content, then click **Save** and submit a commit message to create it.

    <img src="https://mintcdn.com/qontext/GFZ9fVfZmIXg9EJQ/images/Qontext-new-file-creation.png?fit=max&auto=format&n=GFZ9fVfZmIXg9EJQ&q=85&s=c199b0800d03c0a806dfff3ec222749c" alt="Qontext New File Creation" title="Qontext New File Creation" style={{ width:"94%" }} width="1818" height="812" data-path="images/Qontext-new-file-creation.png" />
  </Step>
</Steps>

***

## Editing files

<Steps>
  <Step title="Select a file">
    Open the **Context** tab and select a file from the repository tree.
  </Step>

  <Step title="Edit the content">
    Update content using the formatting toolbar or Markdown shortcuts.

    <img src="https://mintcdn.com/qontext/GFZ9fVfZmIXg9EJQ/images/Qontext-editor.png?fit=max&auto=format&n=GFZ9fVfZmIXg9EJQ&q=85&s=0210aced81b6d5ea48bdfcecca13bbf1" alt="Qontext Editor" title="Qontext Editor" style={{ width:"62%" }} width="1220" height="1000" data-path="images/Qontext-editor.png" />
  </Step>

  <Step title="Save your changes">
    Click **Save** and submit a commit message to finalize the edit.
  </Step>
</Steps>

Additionally, you can:

* **Rename** files directly in the editor by changing the title and confirming the update.
* **Delete** a file directly in the Qontext app by using the delete action and confirming it. Deletion is permanent.
* Switch to the **raw Markdown editor** via the selector at the top right to edit the raw Markdown directly.