Folders

Organize and search collections of documents with Folders. Build a reusable, searchable knowledge base that you can reference in any chat and share across your team.

Folders are the building blocks of the Odeus Knowledge Hub. Instead of re-uploading the same files every time, you collect documents in a Folder once and reference it in any chat with a simple @mention.

When you @mention a Folder, Odeus uses retrieval (embedding search plus a reranker) to find the passages most relevant to your question and feeds only those to the model — with inline citations back to the exact file, page, and location. This lets you work with far more material than you could ever attach to a single message.

Key features:

• Searchable with retrieval (RAG) and bbox-level source citations
• Shareable with individuals, groups, or your entire workspace
• Usable in chat via @mentions, and in Agents as knowledge

Use Folders for large reference sets — manuals, policies, product docs — where you want Odeus to find and cite the relevant sections. For a small number of documents where the model should read the whole thing, attach the files directly to the chat instead.

Where to find Folders

Folders live in the Library. Open the Library from the left sidebar and find the Folders section. You can filter between All, Shared, and Private folders using the view tabs.

Creating a Folder

Click **Library** in the left sidebar.



In the Folders section, click **New Folder** and give it a descriptive name. You can add an optional description so teammates know what it contains.



Your folder is ready. Add files right away or configure sharing first.

Adding documents

Open a folder and click Add Files, or drag and drop files into it. Documents are processed and indexed in the background; once processing completes they become searchable.

Odeus ingests PDF (with layout and OCR, including Arabic), DOCX, XLSX, PPTX, CSV, TXT, Markdown, HTML, and images, up to 50 MB per file. See supported file types for the complete list.

Using Folders in chat

In any chat input, type `@` to open the actions menu.



Start typing the folder's name. It appears alongside your connectors, Agents, and saved prompts.



Pick the folder, then ask your question. Odeus searches the folder's documents and answers with citations to the relevant sources.

A Folder @mention runs retrieval — Odeus sends only the most relevant passages to the model, not every document. For complete-document analysis, attach the file directly to the chat instead.

Example

If you have a folder called "Product Documentation":

@Product Documentation How do I reset my password?

Odeus searches the folder, finds the sections about password reset, and answers from that content with citations.

Sharing Folders

Folders are built for team knowledge bases and support flexible sharing.

Who you can share with

• Individual users — specific people in your workspace.
• Groups — defined user groups, for team-wide access without per-person management.
• Workspace — everyone in your workspace, for company-wide resources like policies.

Permission levels

Permission	Owner	Editor	Viewer
View folder and contents	Yes	Yes	Yes
Search the folder in chat	Yes	Yes	Yes
Add or remove files	Yes	Yes	No
Share with others	Yes	Yes	No
Delete folder	Yes	No	No

• Owner — full control, including deleting the folder.
• Editor — can add and remove documents and share with others.
• Viewer — can search the folder in chat and Agents.

Workspace admins have full control over all folders.

How to share

1. Open your folder.
2. Click Share.
3. Search for users or groups.
4. Choose a permission level (Editor or Viewer).
5. Confirm.

Folders vs direct attachments

• Use Folders when — * You have many documents to search across * You want to reuse the same set across multiple chats * You're building a team knowledge base * You only need the relevant sections, with citations * The material is reference content (manuals, policies, FAQs)

• Use direct attachments when — * You have only a few documents * You want the model to read the entire content * The documents are specific to one conversation * You need maximum fidelity for that specific file

Using Folders with Agents

You can attach a Folder to an Agent's knowledge so the Agent automatically searches it when answering relevant questions. Open the Agent builder, go to the Knowledge section, and add the Folder.

Best practices

• Organize by topic — separate folders for HR policies, product docs, technical guides, and so on.
• Use descriptive names so people know what each folder holds at a glance.
• Keep folders current — remove outdated documents and add new ones.
• Set least-privilege sharing — grant Viewer unless someone needs to edit.

Troubleshooting

* Confirm you have at least Viewer access.
* Check the spelling of the folder name.
* Type more of the name to narrow the results.



* Make sure your documents finished processing.
* Rephrase your question with more specific keywords.
* Verify the information actually exists in the uploaded documents.

Related resources

• Library — the Library and its sections
• Recent Files — uploaded and generated files
• Supported file types