Image, Video, File, And Audio
Image, video, file, and audio fields store uploaded resources. These field types share the same upload configuration; the field type controls the expected resource category.
Use resource fields when records need attachments, evidence, media, documents, or other uploaded files.
Basic Settings
| Setting | Description |
|---|---|
| Name | The field label shown to users. It is required and should describe the uploaded resources clearly |
| API Name | The stable technical name used by data APIs, scripts, formulas, imports, and integrations. It is required |
| Required | Requires users to upload resources before the record can be saved |
| Readonly | Shows uploaded resources but prevents users from changing them |
| Disabled | Makes the field unavailable for normal use |
| Hidden | Stores uploaded resources while hiding them from normal form pages |
Asset Field Config
| Setting | Description |
|---|---|
| Storage Policy Key | Storage policy used by uploaded resources |
| Upload Button Text | Text shown on the upload button |
| Allow Preview | Shows a preview entry only for uploaded files that Soln can preview. Files that are allowed for upload but not supported for preview still appear in the list and can be downloaded when download is enabled |
| Allow Download | Allows users to download uploaded resources |
| Show Upload List | Shows uploaded items in the field |
| List Type | Controls the visual style of the upload list |
| Validate Trigger | Controls when upload validation runs: when the value changes, when the field loses focus, or when the record is submitted |
| Min Count | Minimum number of uploaded items required |
| Max Count | Maximum number of uploaded items allowed |
| Allowed Extensions | File extensions allowed for upload |
| Max Size (MB) | Maximum size for each uploaded item |
| Empty Text | Text shown when no resources are uploaded |
| Invalid Type Message | Custom message shown when a file type is not allowed |
| Max Count Message | Custom message shown when the upload count exceeds the limit |
| Max Size Message | Custom message shown when an uploaded item is too large |
| Upload Failed Message | Custom message shown when upload fails |
| Help Text | Helper copy shown near the field. Use it to explain file requirements |
| Field Color | Sets the display color used for the field |
Preview Support
Upload rules and preview support are separate. Allowed Extensions controls what users can upload. Allow Preview only controls whether Soln may show a preview entry for files that the current preview viewer supports.
When Allow Preview is enabled:
- Supported files show a preview entry in upload lists, compact lists, and table cells
- Unsupported files do not show a preview entry. Users will not open a preview dialog just to see an unsupported-format message
- Unsupported files can still be uploaded, displayed by name, and downloaded when
Allow Downloadis enabled
Soln currently previews these simple file types:
| Preview Type | Extensions |
|---|---|
| Images | jpg, jpeg, png, gif, bmp, webp, svg, avif, ico |
pdf | |
| Text and code | txt, md, markdown, json, jsonl, xml, csv, tsv, log, sql, js, jsx, ts, tsx, css, scss, less, html, htm, yml, yaml, toml, ini, cfg, conf, env, properties, mjs, cjs, vue, svelte, java, c, h, cc, cpp, cxx, hpp, cs, go, rs, py, rb, php, sh, bash, zsh, ps1, swift, kt, kts, scala |
| Video | m3u8, mp4, webm, ogv, mov, m4v, 3gp |
| Audio | mp3, wav, m4a, aac, ogg, opus, flac |
Common unsupported examples include archives such as zip, rar, 7z, complex media such as avi, wmv, mkv, rmvb, design/CAD/model files such as fig, sketch, psd, dwg, stl, glb, and columnar data files such as parquet, avro, orc.
Field Type Differences
| Field Type | Typical Use |
|---|---|
| Image | Photos, screenshots, visual evidence |
| Video | Recordings, demonstrations, inspection videos |
| File | Documents, spreadsheets, archives, general attachments |
| Audio | Voice notes, calls, recordings |
Configuration Tips
| Tip | Description |
|---|---|
| Limit extensions | Extension limits reduce invalid uploads and make file requirements clear |
| Set max size | Size limits prevent unexpectedly large uploads |
| Use count limits | Min and max count rules keep the uploaded resource set within the business requirement |
| Enable preview for supported formats | Preview is useful for supported images, PDFs, text/code files, and common audio/video files. Keep download enabled when users may upload unsupported formats such as archives, design files, or specialized data files |