# Documents

***

### What is a document?

Documents can be used to extend information that is available on a resource, such as a [Listing](/the-basics/listings.md), [Reservation](/the-basics/reservations.md), [Amenity](/the-basics/amenities.md), [Guidebook](/the-basics/guidebooks.md), or [Experience](/the-basics/experiences.md). For example, if you have a manual that should be shown as an Amenity, please upload it as a document. Do you have an additional set of house rules that was only available in picture/pdf format? Upload this to a listing.

### Document Limitations

View a list of all limitations below:

| Type                                 | Amount                         |
| ------------------------------------ | ------------------------------ |
| **Amount of documents per resource** | 50                             |
| **File size per document**           | 5 mb                           |
| **Supported File Types**             | PNG, JPG, JPEG, WEBP, GIF, PDF |

### **Security**

Documents are always securely stored within our CDN. We generate unique download URLs for each document. Each URL has a validity of 2 hours, after which it will expire. A refresh will generate a new URL that allows you to download the document.

***

### Frequently Asked Questions

<details>

<summary>Can I download uploaded documents through the backoffice? </summary>

Yes you can!

1. Go to the resource you have the document uploaded to.&#x20;
2. Go to the `Documents` tab
3. Click on download

Voila! Your document is downloaded.&#x20;

</details>

<details>

<summary>Can I recover an deleted document? </summary>

Nope, a deleted document has been shredded, thrown away and we removed all traces of it. Sorry.&#x20;

</details>


---

# 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://support.holidayhero.com/the-basics/guidebooks/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.
