📖 INSTRUCTIONS

1. ⚙️ SETUP

1. Add the File Validator Uploader element to your page.

2. Under FILE SETTINGS, configure the validation rules:

• Allow multiple files
• Allowed extensions — comma-separated values such as pdf, jpg, png
• Max file size (MB)
• Min/Max image width and height (px)

Note: Dimension rules apply only to image files.

3. Enable Make files private and configure Attach private files to (thing) if uploads should follow a record's privacy rules.

4. Customize the element under:

• DROP ZONE
• THEME & COLORS
• BORDER & EFFECTS
• TYPOGRAPHY
• FILE LIST

5. Enable Hide rules summary if you do not want to display the validation rules on the upload element.


2. 🔄 WORKFLOWS

Available element actions:

• Validate file(s)
• Start upload
• Clear

Use Start upload when you want to trigger the upload from a separate submit button instead of uploading immediately after file selection.

Use Clear to reset the selected files and all related states.


3. 🔔 EVENTS

• File selected (before validation)
• Validation passed (all files valid)
• Validation failed (at least one file rejected)
• Upload complete
• Upload error


4. 🚀 TYPICAL WORKFLOW

1. The user drops or selects files.
2. The plugin validates the files automatically.
3. Validation passed can be used to enable your submit button.
4. The submit button runs Start upload.
5. After Upload complete, use This element's Uploaded files to create or update a thing.


5. 📊 STATES

• Uploaded files — list of uploaded files available after Upload complete.

• Status — text value such as idle
, selected
, validating
, valid
, invalid
, partial
, uploading
, uploaded
, and upload_error
.

• Is uploading — yes/no value that can be used to control loading indicators or disable submit buttons.

• Valid files (names) — list of valid file names.

• Rejected files (names) — list of rejected file names.

• Errors (messages) — validation error messages explaining why files were rejected.

• Error codes — structured error identifiers for validation failures.

• Errors JSON — JSON containing detailed validation errors for custom messaging or processing.

• Size / Width / Height — values for the first valid file.

• Sizes / Widths / Heights — lists containing values for valid files in the same order as Valid files.


🔐 VALIDATION & SECURITY

Validation runs client-side to provide immediate feedback and a smooth upload experience.

For security-critical validation and privacy enforcement, always maintain appropriate server-side checks as well.