Admin

Files

Upload, organize or select files allowed for the current owner.

Step-by-step guide

Before you start

Use an administrator account for this feature.

Open this feature

Open /admin/settings/files on your application domain, or use the matching item in the application menu.

Steps

Save settings

Open /settings/files on your own application domain.
Complete these fields in that form: Storage driver, Default max upload (MB), Allowed extensions, Client ID, Browser API Key, App Key, App Secret, API Key, App Name, Access Key, Access Key ID, Secret Access Key, Region, Bucket, Endpoint, Public URL. Their choices and limits are listed below.
Select Save settings. The exact label can change between creating and editing a record.
If validation fails, correct the named field and submit again. After success, reopen the same record and compare the saved values.

Field shown in the form	What to enter	Example / note
Storage driver	Required. Choose one of the options shown by the form.	Use the value required by the task; no example is assumed.
Default max upload (MB)	Required. Enter a whole number. At least 1. No more than 1024.	Use the value required by the task; no example is assumed.
Allowed extensions	Required. No more than 2000 characters.	Use the value required by the task; no example is assumed.
Client ID	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
Browser API Key	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.	Use the value appropriate to your test account; no preset is supplied.
App Key	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
App Secret	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.	Use the value appropriate to your test account; no preset is supplied.
API Key	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
App Name	Optional, unless this form asks for it. No more than 255 characters.	Test record (use a unique value where required).
Access Key	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
Access Key ID	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
Secret Access Key	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.	Use the value appropriate to your test account; no preset is supplied.
Region	Optional, unless this form asks for it. No more than 100 characters.	Use the value required by the task; no example is assumed.
Bucket	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
Endpoint	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.
Public URL	Optional, unless this form asks for it. No more than 255 characters.	Use the value required by the task; no example is assumed.

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
Owner	Required. Choose Select owner. Enter a whole number.
Folder name	Required. No more than 255 characters.
Note	Optional, unless this form asks for it. No more than 1000 characters.
File URL	Required. Enter a complete URL, including https:// where appropriate. No more than 2048 characters.

Form 2 — fields shown in the interface

Field	What to enter or choose
Storage driver	Required. Choose one of the options shown by the form.
Default max upload (MB)	Required. Enter a whole number. At least 1. No more than 1024.
Allowed extensions	Required. No more than 2000 characters.
Client ID	Optional, unless this form asks for it. No more than 255 characters.
Browser API Key	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.
App Key	Optional, unless this form asks for it. No more than 255 characters.
App Secret	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.
API Key	Optional, unless this form asks for it. No more than 255 characters.
API Key	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.
App Name	Optional, unless this form asks for it. No more than 255 characters.
Access Key	Optional, unless this form asks for it. No more than 255 characters.
Access Key ID	Optional, unless this form asks for it. No more than 255 characters.
Secret Access Key	Optional, unless this form asks for it. No more than 255 characters. Enter the real value privately; do not put it in a screenshot or support message.
Region	Optional, unless this form asks for it. No more than 100 characters.
Bucket	Optional, unless this form asks for it. No more than 255 characters.
Endpoint	Optional, unless this form asks for it. No more than 255 characters.
Public URL	Optional, unless this form asks for it. No more than 255 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.

Messages defined for this screen

Message	What to review
Folder owner does not match the selected user.	Check the related field or action in this role’s form.
A folder with this name already exists.	Check the related field or action in this role’s form.
A folder with this name already exists.	Check the related field or action in this role’s form.

Technical reference

Role-scoped source references

Pinned commit: 37d44a1727216f5c492205024b323aa522730ebc

Source-only route information

Method	Source-default route
LIVEWIRE	/settings/files
LIVEWIRE	/admin/settings/files
GET	/admin/files
GET	/admin/files/browse
GET	/admin/files/picker/images
POST	/admin/files/picker/images/folder
DELETE	/admin/files/picker/images/{fileKey}
POST	/admin/files/picker/images/upload
POST	/admin/files/picker/images/upload-from-url
POST	/admin/files/picker/images/search-online
POST	/admin/files/picker/images/import-google-drive
POST	/admin/files/picker/images/import-adobe-express
GET	/admin/files/{file}/preview
GET	/admin/files/{file}/download
LIVEWIRE	/admin/files/{file}/edit-image
POST	/admin/files/{file}/edit-image

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/AdminIndex.php
uploads	modules/App/AppFiles/Livewire/AdminIndex.php
uploads.*	modules/App/AppFiles/Livewire/AdminIndex.php
appfiles_upload_from_url	modules/App/AppFiles/Livewire/Settings.php
appfiles_google_drive	modules/App/AppFiles/Livewire/Settings.php
appfiles_dropbox	modules/App/AppFiles/Livewire/Settings.php
appfiles_onedrive	modules/App/AppFiles/Livewire/Settings.php
appfiles_onedrive_tenant_id	modules/App/AppFiles/Livewire/Settings.php
appfiles_adobe_express	modules/App/AppFiles/Livewire/Settings.php
appfiles_quick_delete_action	modules/App/AppFiles/Livewire/Settings.php
file_unsplash_status	modules/App/AppFiles/Livewire/Settings.php
file_pexels_status	modules/App/AppFiles/Livewire/Settings.php
file_pixabay_status	modules/App/AppFiles/Livewire/Settings.php
appfiles_amazon_use_path_style_endpoint	modules/App/AppFiles/Livewire/Settings.php
appfiles_wasabi_use_path_style_endpoint	modules/App/AppFiles/Livewire/Settings.php
appfiles_contabo_use_path_style_endpoint	modules/App/AppFiles/Livewire/Settings.php
folder	modules/App/AppFiles/Http/Controllers/AdminFileController.php
name	modules/App/AppFiles/Http/Controllers/AdminFileController.php
note	modules/App/AppFiles/Http/Controllers/AdminFileController.php
files	modules/App/AppFiles/Http/Controllers/AdminFileController.php
files.*	modules/App/AppFiles/Http/Controllers/AdminFileController.php
owner_user_id	modules/App/AppFiles/Http/Controllers/AdminFileController.php
remote_url	modules/App/AppFiles/Http/Controllers/AdminFileController.php
file_id	modules/App/AppFiles/Http/Controllers/AdminFileController.php
type	modules/App/AppFiles/Http/Controllers/AdminFileController.php
name	modules/App/AppFiles/Http/Controllers/AdminFileController.php
mime_type	modules/App/AppFiles/Http/Controllers/AdminFileController.php
resource_key	modules/App/AppFiles/Http/Controllers/AdminFileController.php
data_url	modules/App/AppFiles/Http/Controllers/AdminFileController.php