File Uploads

> Get files into your workspace storage via forms, flows, or the dashboard.

There are several ways to upload files to your workspace. Each method suits a different use case.

Upload via forms

The simplest way to collect files from users is through a form with a File or Image field.

1. Add a File or Image field to your form in the form builder. 2. Configure accepted file types and size limits. 3. When a user submits the form, uploaded files are automatically stored in your workspace storage.

The submission data includes a file reference object that you can use in trigger flows to process the upload further.

Use the Image field type when you only want to accept image files. It provides a preview and restricts uploads to image formats by default.

Upload via nodes

In the Builder, use the upload-file node to store files programmatically as part of a flow.

• Input: The file data and an optional file name
• Output: A file reference object with the storage URL

This is useful when your route receives file data from an external source or generates files.

Upload via dashboard

You can upload files directly from the storage section of the dashboard:

1. Navigate to Dashboard > Storage. 2. Click Upload and select files from your device.

File type detection

Brickr automatically detects the MIME type of uploaded files based on their content and extension. This information is stored alongside the file and used when serving the file to ensure browsers handle it correctly.

Common detected types:

| Extension | MIME Type | |-----------|----------| | .jpg, .jpeg | image/jpeg | | .png | image/png | | .gif | image/gif | | .webp | image/webp | | .pdf | application/pdf | | .csv | text/csv | | .json | application/json | | .txt | text/plain |

File reference object

When a file is uploaded, Brickr creates a file reference object containing:

| Property | Description | |----------|-------------| | url | The URL to access the file | | name | The original file name | | size | File size in bytes | | type | MIME type |

This object is the standard way files are passed between nodes in the Builder.

What's next?

| Topic | Description | |-------|-------------| | Storage Overview | Workspace storage overview | | Forms | Build forms with file upload fields | | Type System | Learn about the file structure type |