Uploading Image Files
Updated
by Firewood Camps Support
Firewood uses a custom file uploader - it's set up to automatically shrink your image files by up to 80% - which helps speed up your website and accelerate page load times.
Firewood Camps Image Uploader – User Guide
What the Firewood Image uploader does
Our uploader lets you pick, edit, compress the file size and directly upload a single image, then stores the file on our secure servers. The whole flow happens in a modal Dashboard that you open with the Upload button in any form.
Step-by-step workflow
Step | Action | UI Hint |
1 | Click the Upload button (paper-clip icon) | Opens the Uppy Dashboard |
2 | Pick an image ≤ 5.2 MB | Only one file allowed ( |
3 | (Optional) Click the ✎ icon to Edit | Crop, rotate, flip, zoom |
4 | Uppy auto-compresses to ~60 % of original size | Faster uploads on slow links |
5 | Wait for the green Upload complete banner | Hidden |
6 | Save the form | Persists the attachment in Rails |
Important: Uploading alone does not update the record. Be sure to hit Save (or Update) and exit the modal before navigating elsewhere, otherwise the new image wil be discarded.
Key features
- Dashboard UI – Drag-and-drop area, preview thumbnails, real-time progress bar, pause/resume and cancel
- Image Editor plugin – Non-destructive crop (free, square, widescreen), rotate, granular rotate, flip, and zoom tools right inside the Dashboard.
- Compressor plugin – Client-side JPEG/PNG/WebP optimization that typically cuts image size by ~60% and speeds up your website. SVGs have mixed support.
- Active Storage Direct Upload – Bypasses Rails app servers, streams straight to your cloud storage
- Strict file restrictions – Max 1 file, 5.2 MB, images only. Validation occurs before any data leaves the browser.
Troubleshooting
Symptom | Cause | Fix |
Upload appears to finish but image isn’t on record | Form wasn’t saved | Click Save/Update after upload, then close modal |
“File type not allowed” | Non-image file chosen | Select JPG, PNG, WebP, or GIF ≤ 5.2 MB - SVGs have roughly 75% support |
Stuck at “Uploading…” | Network drop during direct upload | Wait; Uppy auto-retries, or cancel and retry |
