# Documents

Documents management in GLPI allows to store digital documents or web links sorted under different headings.

A document is described by a **name** and an **comment** and can be associated to a **heading**.

The file corresponding to the document can be added in several ways:

* From local disk;
* Using a web link pointing to a document (image, HTML page, PDF...);
* Using a file previously transferred with FTP to sub-folder */files/\_uploads/* of GLPI installation

A MIME type can also be given.

{% hint style="info" %}
\* Document types authorized in GLPI according to their extension are defined in **Setup** > **Dropdowns** > **Management** > **Document types** To see the different types of files that can be downloaded, go to [this section](https://github.com/glpi-network/gitbook/blob/main/manual/modules/management/documents.html#downloadable-file-types) \* Document headings can be hierarchical \* The option **Blacklisted for import** allows to exclude this document from import by collectors; it is useful for signature images, logos...
{% endhint %}

![A GLPI document](/files/tQys8J8qSe5Drs9pgbNG)

## The different tabs

### Associated Items

This field refers to all items linked to the document.

![associate a document to a GLPI object](/files/FKf3FwqIbOOniVI7Ipec)

It is possible to link several types of objects to GLPI :

<details>

<summary>list of linkable items</summary>

* Appliance
* Battery
* Battery item
* Budget
* Camera
* Camera item
* Cartridge Model
* Case
* Case item
* Certificate
* Change
* Change task
* Cluster
* Computer
* Consumable model
* Contact
* Contract
* Controller
* Controller item
* Database instance
* Device
* Document
* Drive
* Drive item
* Entity
* Firmware
* Firmware item
* Followup
* Generic device
* Generic device item
* Graphics cards
* Graphics cards item
* Hard drive
* Hard drive item
* Knowledge base
* License
* Line
* Memory
* Memory item
* Monitor
* Network card
* Network card item
* Network device
* PCI device
* PCI device item
* Phone
* Power supply
* Power supply item
* Printer
* Problem
* Problem task
* Processor
* Processor item
* Project
* Project task
* Reminder
* Sensor
* Sensor item
* Sim card
* Sim card item
* Software
* Solution
* Sound card
* Sound card item
* Supplier
* System board
* System board item
* Ticket
* Ticket task
* User

</details>

### Documents

It is possible in GLPI to attach other documents to a document, which explains why a `Document` has a `Document` tab.

![A GLPI document](/files/GVZ63hAPZXplVvGgLRNj)

### Notes

The *Notes* tab provides a free text field for storing additional information. Notes are displayed in the order of their creation. You can also add a document

#### Add a note

* To add a note, click on **+Add**
* You can add text and format it to suit your needs
* You can add a document to this note

#### Delete a note

* To delete a note, you need to click on **delete**
* You can delete only the attachment by clicking on delete (the option appears when you move your mouse over the attachment)

{% hint style="success" %}
When you delete an attachment, it is not completely deleted, you can find it in **Management** > **Documents**
{% endhint %}

## History

The *History* tab is used to show any changes made to an item. The following information about the changes is available:

* ID of the change.
* Date and time the change was made.
* User who made the change. If this field is not filled, it means that the action was done automatically (For example: automatic inventory update).
* Field that was changed.
* Description of the change that was made.

The description of the change represents either the difference between the old and the new value (For example with location field: Change HQ to Remote Office A), or the explanation of the action which was carried out (For example: Uninstallation of a software: "Gimp 2.0").

{% hint style="info" %}
For dropdowns or objects with a parent/child relationship, the modification of a child will appear in the history of the parent element.
{% endhint %}

## All Information

For an item, all information is displayed on one page from the *All* tab. This shows all of the tabs of an object's form in one view, one below the other.

## Downloadable file types

| NAME                               | EXTENSION | AUTHORIZED UPLOAD BY DEFAULT |
| ---------------------------------- | --------- | ---------------------------- |
| Adobe Illustrator                  | ai        | Yes                          |
| AIFF                               | aiff      | Yes                          |
| BMP                                | bmp       | Yes                          |
| BZip                               | bz2       | Yes                          |
| C header                           | h         | Yes                          |
| C source                           | c         | Yes                          |
| Comma-Separated Values             | csv       | Yes                          |
| Debian                             | deb       | Yes                          |
| DjVu                               | djvu      | Yes                          |
| DVI                                | dvi       | Yes                          |
| Excel                              | xls       | Yes                          |
| Excel                              | XML/xlsx  | Yes                          |
| Flash                              | swf       | Yes                          |
| GIF                                | gif       | Yes                          |
| GIMP multi-layer                   | xcf       | Yes                          |
| GZ                                 | gz        | Yes                          |
| HTML                               | html      | Yes                          |
| JPEG                               | jpg       | Yes                          |
| JPEG                               | jpeg      | Yes                          |
| JSON file                          | json      | Yes                          |
| LaTeX                              | tex       | Yes                          |
| Midi                               | mid       | Yes                          |
| MNG                                | mng       | Yes                          |
| MP3                                | mp3       | Yes                          |
| MPEG                               | mpg       | Yes                          |
| Oasis Open Office Base             | odb       | Yes                          |
| Oasis Open Office Calc             | ods       | Yes                          |
| Oasis Open Office Calc Template    | ots       | Yes                          |
| Oasis Open Office Chart            | odc       | Yes                          |
| Oasis Open Office Draw             | odg       | Yes                          |
| Oasis Open Office Draw Template    | otg       | Yes                          |
| Oasis Open Office HTML             | oth       | Yes                          |
| Oasis Open Office Image            | odi       | Yes                          |
| Oasis Open Office Impress          | odp       | Yes                          |
| Oasis Open Office Impress Template | otp       | Yes                          |
| Oasis Open Office Math             | odf       | Yes                          |
| Oasis Open Office Writer           | odt       | Yes                          |
| Oasis Open Office Writer Master    | odm       | Yes                          |
| Oasis Open Office Writer Template  | ott       | Yes                          |
| Ogg Vorbis                         | ogg       | Yes                          |
| OpenOffice                         | sxw       | Yes                          |
| OpenOffice Calc                    | sxc       | Yes                          |
| OpenOffice Impress                 | sxi       | Yes                          |
| Pascal                             | pas       | Yes                          |
| PDF                                | pdf       | Yes                          |
| Photoshop                          | psd       | Yes                          |
| PNG                                | png       | Yes                          |
| PostScript                         | eps       | Yes                          |
| PostScript                         | ps        | Yes                          |
| PowerPoint                         | ppt       | Yes                          |
| PowerPoint                         | XML/pptx  | Yes                          |
| QuickTime                          | mov       | Yes                          |
| QuickTime                          | question  | Yes                          |
| RealAudio                          | ra        | Yes                          |
| RealAudio                          | ram       | Yes                          |
| RealAudio                          | rm        | Yes                          |
| RedHat/Mandrake/SuSE               | rpm       | Yes                          |
| RTF                                | rtf       | Yes                          |
| Scalable Vector Graphics           | svg       | Yes                          |
| StarOffice                         | sdd       | Yes                          |
| StarOffice                         | sdw       | Yes                          |
| Stuffit                            | sit       | Yes                          |
| texte                              | txt       | Yes                          |
| TGZ                                | tgz       | Yes                          |
| TIFF                               | tif       | Yes                          |
| WAV                                | wav       | Yes                          |
| Windows Media                      | asf       | Yes                          |
| Windows Media                      | avi       | Yes                          |
| Windows Media                      | wmv       | Yes                          |
| Word                               | doc       | Yes                          |
| Word                               | XML/docx  | Yes                          |
| xml                                | xml       | Yes                          |
| zip                                | zip       | Yes                          |


---

# Agent Instructions: 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://help.glpi-project.org/documentation/modules/management/documents.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.
