# Attachments

This article explains how **attachments** work in Model Reef.

You will learn:

* What kinds of files you can attach.
* Where attachments can be added.
* How attachments support documentation, review and audit.

Attachments keep evidence and context close to the assumptions they support.

{% stepper %}
{% step %}

### What you can attach

You can upload files such as:

* PDFs (for example contracts, board packs, loan agreements).
* Spreadsheets and CSV files.
* Images (for example screenshots or charts).
* Other relevant documents that help explain or justify assumptions.

Attachments are stored with the model and associated with specific objects.
{% endstep %}

{% step %}

### Where attachments can be added

Attachments can be linked to:

* Variables and drivers, to document the source of numbers.
* Branches, to document entity or project level materials.
* Data Library entries, to show source data or methodologies.

This makes it easy to find the documentation relevant to a particular assumption or part of the model.
{% endstep %}

{% step %}

### Roles and access to attachments

Permissions behave as follows:

* **Owners and Editors**
  * Can upload, update and remove attachments on objects they can access.
* **Viewers**
  * Can view and download attachments on objects they can access.
  * Cannot upload or delete attachments.

Branch level permissions still control which attachments are visible to each user based on where the attachment is linked.
{% endstep %}

{% step %}

### Best practices for attachments

To use attachments effectively:

* Attach key source documents to the variables they support.
* Include a note summarising what the attachment contains and which numbers it supports.
* Keep naming consistent so that it is clear which version of a document is current.
* Remove obsolete attachments if they are replaced, or clearly label them as superseded.

This improves auditability and reduces time spent searching for source documents.
{% endstep %}
{% endstepper %}

***

## Related articles

* [Board/Investor Reporting for Clients](/use-cases/accounting-firms-and-advisors/board-investor-reporting-for-clients.md)
* [Investment & Transactions](/how-tos/investment-and-transactions.md)
* [Subcategories](/help/building-your-model/subcategories.md)
* [How to Enter Values](/syntax/how-input-fields-work/how-to-enter-values.md)


---

# 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.modelreef.io/help/permissions-and-collaboration/attachments.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.