# File Attachments

File Attachments let you upload files and images to your batches and recipes. Attach brew day photos, lab reports, label designs, tasting notes, and any other documents you want to keep with your brewing records.

> Tip
>
> File Attachments require a **Premium Plus** subscription. See [Subscription](/account/subscription.md) for details.

## Supported File Types

You can upload the following file types:

* **Images**: JPEG, JPG, PNG, GIF, WebP, HEIC, HEIF
* **Documents**: PDF
* **Spreadsheets**: XLS, XLSX
* **Word documents**: DOC, DOCX
* **Text files**: TXT, CSV

## Upload Limits

* **Maximum file size**: 20 MB per file
* **Maximum files per item**: 20 files per batch or recipe
* **Storage quota**: 5 GB total for Premium Plus (see [Storage Quota](#storage-quota) below)

## Uploading Files

### From the File Browser

1. Open a batch or recipe
2. Scroll to the **Attachments** section
3. Tap the **Upload** button
4. Select one or more files from your device
5. Files upload with a progress indicator

### Drag and Drop (Desktop)

1. Open a batch or recipe
2. Drag files from your computer onto the **Attachments** section
3. The drop zone highlights when files are over it
4. Release to start uploading

Multiple files can be uploaded at once. Each file is validated for size and type before uploading.

## Viewing Attachments

Attachments appear in a list within the Attachments section of your batch or recipe:

* **Images** show thumbnail previews (generated in multiple sizes: 72px, 192px, and 640px)
* **Documents** show a file type icon (PDF, spreadsheet, word document, etc.)
* Each attachment displays the file name and file size

Tap an image attachment to open a full-screen preview. Tap a document attachment to download it.

## Deleting Attachments

1. Tap the delete icon on the attachment you want to remove
2. Confirm the deletion

Deleting an attachment frees up storage quota immediately. This action cannot be undone.

## Collapsing the Attachments Section

The Attachments section can be collapsed to save screen space:

* Tap the section header to toggle between expanded and collapsed views
* The collapsed header shows the number of attachments

## Storage Quota

Your file attachment storage is shared across all batches and recipes. The storage quota depends on your subscription plan:

| Plan         | Storage Quota |
| ------------ | ------------- |
| Premium Plus | 5 GB          |

### Checking Your Storage Usage

Your current storage usage is displayed as a progress bar showing:

* **Used storage** out of your total quota
* **File count** — total number of files across all batches and recipes
* **Color indicator**:
  * Normal (under 75% used)
  * Warning (75%–90% used)
  * Danger (over 90% used)

You can view your storage usage from the storage indicator in the Attachments section or from the Account page.

### When Storage Is Full

If you reach your storage quota, you will not be able to upload new files until you free up space by deleting existing attachments.

> Tip
>
> To free up storage, review older batches and remove attachments you no longer need. Images tend to use the most space — consider resizing large photos before uploading.

## Related docs

* [Recipes](/recipes.md)
* [Batches](/batches.md)
* [Versioning](/recipes/versioning.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://docs.brewfather.app/file-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.