# Documents

The documents tool is your course's file repository. You can upload files, create web pages, organize content into folders, and give learners access to all the materials they need.

## Accessing the Documents Tool

Open the **Documents** <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-8f7e3e3fa5fec6c8a5de49121594ce6d587aa3a4%2Fmdi-bookshelf.svg?alt=media" alt="Documents" data-size="line"> tool from the course homepage. You will see a file browser showing the root folder of your course's document library.

![The documents file browser showing folders and files with action icons](https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-fa24e49f439c893c3d0740bccf646437794879e3%2Fdocuments-file-browser.png?alt=media)

## Uploading Files

1. Click the **Upload** <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-f69b8e7c9c818542ed8ad5f3b144bb799113aab9%2Fmdi-upload.svg?alt=media" alt="Upload" data-size="line"> button
2. Select one or more files from your computer (you can drag and drop files into the upload area)
3. The files are uploaded and appear in the current folder

Chamilo supports most common file types: PDF, Word documents (.docx), PowerPoint presentations (.pptx), Excel spreadsheets (.xlsx), images (PNG, JPG, SVG, GIF), audio files, video files, HTML files, and more.

## Creating Content

In addition to uploading files, you can create content directly in Chamilo:

### Web Pages

1. Click **Create a document**
2. Use the rich-text editor to write your content with formatting, images, tables, and links
3. Enter a **file name** for the page
4. Save

The rich-text editor (TinyMCE) provides word-processor-like features including:

* Text formatting (bold, italic, headings, lists)
* Tables
* Images (upload or link to existing images)
* Embedded videos and audio
* Links to other resources
* HTML source editing for advanced users

### Drawing

Chamilo includes a built-in drawing tool that lets you create simple diagrams and illustrations directly in the browser.

### Audio Recording

If your browser supports it, you can record audio directly within the documents tool — useful for creating audio instructions or language learning content.

## Organizing with Folders

Keep your document library organized using folders:

1. Click **Create a folder** <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-4b4d0ce754cf742ae83520a8a14df864d77085c2%2Fmdi-folder-plus.svg?alt=media" alt="New folder" data-size="line">
2. Enter a folder name
3. Save

You can create nested folders to build a logical content hierarchy (e.g., `Module 1 > Week 1 > Readings`).

### Moving Files

* Select one or more files using the checkboxes
* Click **Move** <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-da0b4e59adb5df4c07444c17f4f5b7630d8dbf6e%2Fmdi-folder-move.svg?alt=media" alt="Move" data-size="line">
* Select the destination folder
* Confirm

## Managing Documents

For each file or folder, you can:

| Action         | Icon                                                                                                                                                                                                                                                   | Description                                         |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
| **Edit**       | <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-6369c6135a9138074bead2ce94ad7693bf719058%2Fmdi-pencil.svg?alt=media" alt="Edit" data-size="line">           | Rename the file or edit its content (for web pages) |
| **Delete**     | <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-21c80c23ae6145a864b07a6b63304ce29d60d6c7%2Fmdi-delete.svg?alt=media" alt="Delete" data-size="line">         | Remove the file or folder                           |
| **Download**   | <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-02144bd743bc216d0a07e29109d42c6c3b597e70%2Fmdi-download-box.svg?alt=media" alt="Download" data-size="line"> | Download the file to your computer                  |
| **Visibility** | <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-0b6b23a06a96f08bea32e8e7de1252b5982bdc4d%2Fmdi-eye.svg?alt=media" alt="Visibility" data-size="line">        | Hide or show the file to learners                   |
| **Replace**    | <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-47835196599380b172f5d827d2d93d74a220be38%2Fmdi-file-replace.svg?alt=media" alt="Replace" data-size="line">  | Replace the file with an updated version            |
| **Move**       | <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-da0b4e59adb5df4c07444c17f4f5b7630d8dbf6e%2Fmdi-folder-move.svg?alt=media" alt="Move" data-size="line">      | Move to a different folder                          |

### Bulk Actions

Select multiple files using checkboxes, then use the toolbar to delete, move, or change visibility for all selected items at once.

## View Modes

You can switch between two view modes:

* **List view** — Files shown in a detailed list with names, sizes, and dates
* **Grid view** — Files shown as thumbnail cards (useful for image-heavy folders)

## OnlyOffice Integration

If your administrator has configured **OnlyOffice**, you can edit Word, Excel, and PowerPoint files directly in the browser without downloading them. Look for the **Edit with OnlyOffice** <img src="https://3870221420-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSHilSeDtvDev0n1c7wbJ%2Fuploads%2Fgit-blob-00b6be6f916d3563716f3460ffbff20355946bf7%2Fmdi-file-document-edit-outline.svg?alt=media" alt="OnlyOffice" data-size="line"> option when viewing a supported file.

## Cloud Files

If cloud storage is configured (Azure Blob, AWS S3, or Google Cloud), files are stored in the cloud. This is transparent to you and your learners — the document tool works the same way regardless of the storage backend.

## Tips

* **Organize early** — Create your folder structure before uploading content so you don't have to reorganize later
* **Use descriptive file names** — Help learners find what they need with clear, meaningful names
* **Hide work-in-progress** — Use the visibility toggle to hide documents you are still preparing
* **Link from learning paths** — Reference documents within your learning paths to create guided learning sequences
* **Check the disk quota** — If your course has a storage limit, remove outdated files to free up space
