diff --git a/packages/file-handling/README.md b/packages/file-handling/README.md
index aed16dc5e0272015d7f6eacdf928d6f6ac7fdb96..c17e4cab727348cbf7617b8784ac142d5e95159a 100644
--- a/packages/file-handling/README.md
+++ b/packages/file-handling/README.md
@@ -31,6 +31,14 @@
     - example `<vpu-file-source nextcloud-web-dav-url="http://localhost:8081/remote.php/dav/files"></vpu-file-source>`
     - `nextcloud-auth-url` also needs to be set for the Nextcloud file picker to be active
 
+### Events
+
+#### `vpu-file-source-file-selected`
+
+This event is sent if a file was selected.
+
+**Payload**: `{'file': File}` where `File` is the binary file that was selected
+
 ## Local development
 
 ```bash