Files
Upload, organize or select files allowed for the current owner.
Before you start
Use the account and workspace that own the records. This page does not include administrator configuration forms.
Open /portal/files on your application domain, or use the matching item in the application menu.
Steps
Example: create a folder and upload one file
- Open Files in the workspace that should own the file.
- Select New folder. Enter Test files in Folder name and add a Note if needed.
- Select Create Folder and open the folder you just created.
- Select Upload files and choose a small test file allowed by the file picker. Upload starts automatically after selection; there is no separate save step for this upload flow.
- Wait for the upload to finish, close the upload dialog and check that the file appears in the current folder.
- Open its preview or download action. Confirm the file belongs to this workspace.
Rename the folder
- Open the folder’s edit/rename control.
- Change Folder name and the optional Note.
- Select Save changes and verify the new name in Files.
Fields shown in the interface
Only fields traced to this role’s handler and its own view are listed. The application can show separate create/edit forms; do not fill every row on one screen.
Form 1 — fields shown in the interface
| Field | What to enter or choose |
|---|---|
| Folder name | Required. No more than 255 characters. |
| Note | Optional, unless this form asks for it. No more than 1000 characters. |
Check the result
After a source-checked procedure, verify the same record in the same workspace. Check saved values, visible state and access with the intended test account. An external payment/message/provider action needs its own result check.
Problems and validation
| Problem | Next step |
|---|---|
| A field rejects the value | Check its named error, the form’s visible choices and the relevant limit. Do not substitute internal numeric codes for the displayed options. |
| The control is missing | Check role, plan, enabled app and current record state. Do not grant administrator access merely to complete a User task. |
| The saved result is unexpected | Reopen the same record and verify its owner/workspace before repeating the action. |
Technical reference
Role-scoped source references
Pinned commit: 68a5655db1bbe17c74fb211f0fe0ee4e63c8be88
- modules/App/AppFiles/Http/Controllers/PortalFileController.php
- modules/App/AppFiles/Livewire/PortalImageEditor.php
- modules/App/AppFiles/Livewire/PortalIndex.php
- modules/App/AppFiles/Livewire/PortalSearchOnline.php
- modules/App/AppFiles/resources/views/editor.blade.php
- modules/App/AppFiles/resources/views/partials/adobe-express-script.blade.php
- modules/App/AppFiles/resources/views/partials/dropbox-chooser-script.blade.php
- modules/App/AppFiles/resources/views/partials/editor-script.blade.php
- modules/App/AppFiles/resources/views/partials/google-picker-script.blade.php
- modules/App/AppFiles/resources/views/partials/onedrive-picker-script.blade.php
- modules/App/AppFiles/resources/views/portal/index.blade.php
- modules/App/AppFiles/resources/views/portal/search-online.blade.php
Source-only route information
| Method | Source-default route |
|---|---|
| GET | /portal/files/publish/{file}/preview |
| LIVEWIRE | /portal/files |
| LIVEWIRE | /portal/files/search-online |
| GET | /portal/files/picker/media |
| POST | /portal/files/picker/media/folder |
| DELETE | /portal/files/picker/media/{fileKey} |
| POST | /portal/files/picker/media/upload |
| POST | /portal/files/picker/media/upload-from-url |
| POST | /portal/files/picker/media/search-online |
| POST | /portal/files/picker/media/import-google-drive |
| POST | /portal/files/picker/media/import-adobe-express |
| GET | /portal/files/{file}/preview |
| GET | /portal/files/{file}/download |
| LIVEWIRE | /portal/files/{file}/edit-image |
| POST | /portal/files/{file}/edit-image |
| DELETE | /portal/files/{file} |
Unmapped fields — not user instructions
These fields belong to this role’s source handler, but their screen labels were not confirmed.
| Source key | Handler |
|---|---|
| editing_folder | modules/App/AppFiles/Livewire/PortalIndex.php |
| remote_url | modules/App/AppFiles/Livewire/PortalIndex.php |
| uploads | modules/App/AppFiles/Livewire/PortalIndex.php |
| uploads.* | modules/App/AppFiles/Livewire/PortalIndex.php |
| folder | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| name | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| note | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| files | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| files.* | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| remote_url | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| file_id | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| type | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| name | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| mime_type | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| resource_key | modules/App/AppFiles/Http/Controllers/PortalFileController.php |
| data_url | modules/App/AppFiles/Http/Controllers/PortalFileController.php |