Browsing & Managing Files
The Files page is where you'll browse every attachment uploaded through your form, regardless of which submission it came from. It complements the Submissions page when you want a file-first view instead of a submission-first one.
New forms start with File Uploads off. Enable the switch in General Settings before attachments will be accepted.
Accessing the Files page
Navigate to any form and click the "Files" tab in the form's navigation menu, right after Submissions. You'll see all attachments for that form, displayed as a responsive grid of cards.
Each card shows a thumbnail (for images), the file name, content type, size, and the date it was uploaded. Non-image files render a typed icon (PDF, document, spreadsheet, archive, etc.).
Previewing a file
- Images: click the preview area to open the image in a larger modal.
- PDFs: click the preview to open the file in a new browser tab using the native PDF viewer.
- Other types: click the preview to trigger a direct download.
The download icon in the card footer always triggers a download with the original file name, no matter the type.
Searching, filtering, and sorting
The toolbar above the grid lets you narrow down what's visible:
- Search: case-insensitive match against the file name.
- Type filter: limit results to Images, PDFs, Documents, Spreadsheets, Archives, or Other.
- Sort: Newest (default), Oldest, Largest, Smallest, Name A → Z, or Name Z → A.
All three controls are reflected in the URL. Share the URL and the recipient lands on the same filtered view; refresh the page and your filters stick.
Bulk actions
Each card has a checkbox overlay in the top-left of the preview, and the toolbar exposes a master "Select all" checkbox plus an Actions menu:
- Download selected: fetches every selected file in parallel and triggers each download. Your browser may ask once to allow multiple downloads from the site.
- Delete selected: removes the selected files from storage and from your form (requires the Admin or Developer role).
The Files page summary in the page header swaps to "N selected" as soon as you tick the first card, so you always know how many files an action will affect.
Deletes are permanent. The files are removed from the bucket and from the linked submission's attachment list, submissions themselves are kept intact.
Relationship with submissions
Every file in the Files explorer is linked to the submission that produced it. From the Submissions page:
- Collapsed submissions display a paperclip badge with the attachment count when there are files.
- Expanded submissions show a thumbnail strip, clicking a thumbnail downloads the file.
Deleting a submission cascades to its attachments. Deleting a form removes every file uploaded against it.
Permissions
| Role | View / Download | Delete |
|---|---|---|
| Admin | ✅ | ✅ |
| Developer | ✅ | ✅ |
| Tester | ✅ | ❌ |
| Viewer | ✅ | ❌ |
Next steps
- Learn how to attach files in code:
- Understand the platform limits: