> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/screens-and-components/type-of-components/file-upload.md).

# File upload component

Let end users attach files/images to Notion file properties from Create/Update forms (and related inputs).

## When to use

* Photos from the field
* PDFs / receipts on requests
* Any Notion **Files & media** property that operators must populate from the app

## Maker setup

1. Ensure the Notion property type is files/media (or compatible).
2. Add the **File upload** component on the form / screen.
3. Configure Behaviour (required, helper text) like other inputs.
4. Publish and test on a real phone (camera roll + file picker).

## Tips

* Large images slow lists — compress when possible (see FAQ on slow images).
* Pair with Details [Media Gallery](https://docs.notionapps.com/how-to-guides/media-gallery) when viewers need a polished gallery.
* Reload data after changing the Notion property type ([Databases → Reload and sync](https://docs.notionapps.com/databases/reload-and-sync)).
* For inspection-style “labeled photo categories,” use a related photos database + allow-add list/selector pattern (see Relations docs).

## Related

* [Address](https://docs.notionapps.com/screens-and-components/type-of-components/address)
* [Signature](https://docs.notionapps.com/screens-and-components/type-of-components/signature-component)
* [Field Operations](https://docs.notionapps.com/use-cases/field-operations)
* [Relations](https://docs.notionapps.com/screens-and-components/relations)