User
Add, organize and reuse files
Keep uploaded/imported assets in the workspace library and select them from supported editors. An imported file is not automatically public content.
Step-by-step guide
Before you start
- Choose the correct workspace and make sure Files access/storage allowance is available. Use files you are allowed to upload or import.
Open this feature
- Open /portal/files on your site.
How to use it
Upload a file and locate it
- Open /portal/files and choose the upload/file-picker control. Select a small supported practice file from your computer.
- Wait for completion and check any named file-type, size, quota or storage error.
- Use file search, Category and Sort files to locate the saved asset. Open its details and verify its name/type and preview.
- Create or choose a folder when organizing assets. Add a useful Note if needed; a note is internal context, not a public caption.
Import from a remote URL
- Open the library’s URL-import control and enter a direct reachable file URL, not just a normal webpage containing the file.
- Select Import file and wait for the result. The import must satisfy this installation’s storage/type and remote-access checks.
- Find the imported asset in the library and inspect its actual contents/type before reusing it.
Use or edit an asset
- Open the destination page/editor and use its Files/image picker to select the intended library item.
- Inspect the preview and save that page/editor. Storing a file and saving its use in a page are separate actions.
- When an image editor is offered, inspect the crop/adjustments and use Save to retain the intended result, or Download to export a local copy. Check the resulting file afterwards.
Fields and examples
| Field or choice | How to use it |
|---|---|
| Search / Category / Sort files | Locate existing assets and clear restrictive filters when an expected file is hidden. |
| Folder / Folder name | Organizes library entries; check the selected workspace/folder before uploading or moving files. |
| URL import | Use a direct file URL with permission to import it. A social/webpage URL can return HTML instead of the intended image. |
| Note | Internal asset context; verify what the destination editor actually publishes. |
| Save / Download | Saving in an editor and downloading a local copy have different effects. Inspect the saved asset and destination separately. |
Check your finished result
- Open the saved library asset, then check the destination editor after selecting/saving it.
Problems and fixes
| What you see | What to do next |
|---|---|
| Upload rejected | Read the exact supported type, quota/size and storage error for this installation. |
| Remote import returns the wrong content | Use a direct file URL rather than a page URL. |
| File not found in the picker | Check workspace, folder, file-type filters and picker context. |
| Downloaded edit did not change a page | Choose/save the edited asset in that page; downloading alone does not update the page. |
Technical reference
Role-scoped source references
Pinned commit: ca125291cce57358ac4842e50928bc31fc6eab07
- modules/AppFiles/Http/Controllers/PortalFileController.php
- modules/AppFiles/Livewire/FileLibraryIndex.php
- modules/AppFiles/Livewire/PortalImageEditor.php
- modules/AppFiles/Livewire/PortalSearchOnline.php
- modules/AppFiles/resources/views/editor.blade.php
- modules/AppFiles/resources/views/partials/adobe-express-script.blade.php
- modules/AppFiles/resources/views/partials/dropbox-chooser-script.blade.php
- modules/AppFiles/resources/views/partials/editor-script.blade.php
- modules/AppFiles/resources/views/partials/google-picker-script.blade.php
- modules/AppFiles/resources/views/partials/library-cloud-methods.blade.php
- modules/AppFiles/resources/views/partials/library-style.blade.php
- modules/AppFiles/resources/views/partials/onedrive-picker-script.blade.php
- modules/AppFiles/resources/views/portal/library.blade.php
- modules/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 |
|---|---|
| assetName | modules/AppFiles/Livewire/FileLibraryIndex.php |
| assetNote | modules/AppFiles/Livewire/FileLibraryIndex.php |
| destination | modules/AppFiles/Livewire/FileLibraryIndex.php |
| folder | modules/AppFiles/Http/Controllers/PortalFileController.php |
| name | modules/AppFiles/Http/Controllers/PortalFileController.php |
| note | modules/AppFiles/Http/Controllers/PortalFileController.php |
| files | modules/AppFiles/Http/Controllers/PortalFileController.php |
| files.* | modules/AppFiles/Http/Controllers/PortalFileController.php |
| remote_url | modules/AppFiles/Http/Controllers/PortalFileController.php |
| file_id | modules/AppFiles/Http/Controllers/PortalFileController.php |
| type | modules/AppFiles/Http/Controllers/PortalFileController.php |
| name | modules/AppFiles/Http/Controllers/PortalFileController.php |
| mime_type | modules/AppFiles/Http/Controllers/PortalFileController.php |
| resource_key | modules/AppFiles/Http/Controllers/PortalFileController.php |
| data_url | modules/AppFiles/Http/Controllers/PortalFileController.php |