> For the complete documentation index, see [llms.txt](https://alludium.gitbook.io/alludium-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alludium.gitbook.io/alludium-docs/5.-artifacts/5.3-uploading-artifacts.md).

# Uploading Files

Upload files when you want Alludium to retain material beyond a single message and make it available to future work.

**Location:** Main navigation -> Files

***

## Upload From Files

Use the Files page for reusable workspace material such as templates, examples, playbooks, and standing reference documents.

1. Open **Files** from the main navigation.
2. Select **Upload**.
3. Choose the file or files from your computer.
4. Confirm the upload.
5. Wait for processing to complete before relying on the file in agent output.

After upload, the file appears in the workspace file list and can be previewed, searched, linked, or deleted according to your permissions.

***

## Upload From a Project

Use project file upload when the material belongs to a specific project.

Examples:

* Source documents for a diligence project.
* Client inputs for a proposal project.
* Supporting documents for a project task.
* Generated work that should remain with the project record.

Project files keep the context close to the project tasks that use it.

***

## Upload From Chat

Use chat upload when the file is needed for the current conversation only.

If the same file should be reused later, uploaded for a project, or linked to an agent, add it through **Files** or the relevant project instead of relying on a chat-only upload.

***

## Supported Formats

Alludium is designed for common business documents and data files. Supported handling can vary by workspace configuration, but the most common file types include:

* PDF
* DOCX
* TXT and Markdown
* CSV
* XLSX
* Images for supported vision workflows

For best results, use clean digital documents instead of scanned or image-only PDFs. Structured data should usually be uploaded as CSV or XLSX.

***

## Upload Checklist

Before using a file in production work:

* Confirm the upload completed.
* Preview the file where available.
* Check that the file name is clear.
* Make sure the file belongs in the selected scope: workspace, project, or chat.
* Avoid uploading credentials, secrets, or unnecessary personal data.

***

## Next Step

Continue to **Managing Files** to keep your workspace and project file libraries current.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://alludium.gitbook.io/alludium-docs/5.-artifacts/5.3-uploading-artifacts.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.