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

# Documents and Workspaces

> Learn how to view, manage, upload, and organize documents within workspaces in Paradigm.

## Overview

From the [Documents page](https://paradigm.lighton.ai/documents), you can view and manage all documents you have access to. This interface provides multiple ways to upload, search, filter, preview, and edit documents, depending on your permissions.

***

## 1. Uploading Documents

* Use the **Upload** button in the top-right corner.

<img src="https://mintcdn.com/lighton/kLYkBKsZcJQpZgEl/images/documents-workspaces-uploading-documents.png?fit=max&auto=format&n=kLYkBKsZcJQpZgEl&q=85&s=c211e428cf13daa49d7040be974c30f6" alt="Uploading documents" width="688" height="343" data-path="images/documents-workspaces-uploading-documents.png" />

***

## 2. Searching Documents

* Use the **search bar** to find documents. (Search is **based only on document names**.)

<img src="https://mintcdn.com/lighton/kLYkBKsZcJQpZgEl/images/documents-workspaces-searching-documents.png?fit=max&auto=format&n=kLYkBKsZcJQpZgEl&q=85&s=9388fafaf816910bc87b4aa80e2f53cf" alt="Searching documents" width="688" height="288" data-path="images/documents-workspaces-searching-documents.png" />

***

## 3. Filtering Documents

Use the **filter icon** to refine the list by:

* **Workspace** (folder)
* **Owner** (who uploaded the document)
* **Status** of the document

<img src="https://mintcdn.com/lighton/kLYkBKsZcJQpZgEl/images/documents-workspaces-filtering-documents.png?fit=max&auto=format&n=kLYkBKsZcJQpZgEl&q=85&s=3a43492fe743178b6b4c8e067525dac1" alt="Filtering Documents" width="688" height="201" data-path="images/documents-workspaces-filtering-documents.png" />

### Document Statuses

* **Pending**: Waiting to start processing (e.g., heavy upload load).
* **Parsing**: Document is being split into parts.
* **Parsing failed**: Splitting failed; document unusable.
* **Embedding**: Content is being analyzed and chunked.
* **Embedding failed**: Embedding failed; document unusable.
* **Embedded**: Document is ready to use.
* **Fail**: Generic failure; document unusable.
* **Updating**: Document is being updated (common with synced sources such as Google Drive, SharePoint, ServiceNow, Teams, etc.).

***

## 4. Customizing Columns

Click **Columns** to choose which metadata to display:

* **Citations**: Number of times the document was cited in conversations.
* **Updated**: Last update date.
* **Uploaded**: Original upload date.
* **Owner**: Who uploaded the document.
* **Tags**: Automatically generated tags (created during nightly processing).

<img src="https://mintcdn.com/lighton/kLYkBKsZcJQpZgEl/images/documents-workspaces-customizing-columns.png?fit=max&auto=format&n=kLYkBKsZcJQpZgEl&q=85&s=c35fc5d067d0dc92a71b6de66b2e1bec" alt="Customizing columns" width="1376" height="296" data-path="images/documents-workspaces-customizing-columns.png" />

***

## 5. Workspace Filtering

* Use the left-side menu to filter by **workspace(s)**.

<Tip>
  **Tip:** If you filter by a workspace and then click **Upload**, the selected workspace is automatically applied.
</Tip>

<img src="https://mintcdn.com/lighton/kLYkBKsZcJQpZgEl/images/documents-workspaces-workspace-filtering.png?fit=max&auto=format&n=kLYkBKsZcJQpZgEl&q=85&s=22fe3d0172c62bebed01684e923709e3" alt="Workspace filtering" width="1376" height="295" data-path="images/documents-workspaces-workspace-filtering.png" />

***

## 6. Document Preview & Summary

* **Click a document row** to preview its content.
* Hover over the **"i" icon** next to a document to see its **summary**.

For each document, use the **three-dot menu** to:

* Preview the document
* Rename the document
* Delete the document

<iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1BbAiNyul5fF5m9GmEBQUa0tq_78WDGiV/preview" allow="autoplay" />

***

## 8. Multi-Select and Bulk Actions

* Check one or more boxes next to documents to enable bulk actions:
  * **Explore selected** → Route to chat with these docs preloaded.
  * **Download** → Export selected documents.
  * **Delete** → Remove selected documents.

<iframe className="w-full aspect-video rounded-xl" src="https://drive.google.com/file/d/1i5uRu8WZiynxLlMHXejZGMiEbXGksodE/preview" allow="autoplay" />

<Warning>
  **Permissions and Limitations**

  * The list of documents is limited by your **workspace access** and **user permissions**.
  * If you are **not a Document Manager**, you cannot upload documents into the **Company workspace**.
  * If you cannot see a workspace you should have access to, contact your **admin**.
</Warning>