EmberlyEmberly Docs

File Management

Upload, organize, share, and manage your files in Emberly.

Uploading Files

Web Dashboard

  1. Go to Dashboard → Files
  2. Click "Upload" or drag files onto the page
  3. Files upload automatically — you get a shareable URL instantly

Supported Upload Methods

MethodBest For
Web dashboardQuick one-off uploads
ShareX / FlameshotAutomated screenshot uploads
REST APIProgrammatic uploads
Tauri desktop appNative desktop workflow
PowerShell / BashAutomation scripts

File Visibility

VisibilityWho Can Access
PUBLICAnyone with the URL
PRIVATEOnly you and named collaborators

Change visibility anytime by clicking a file → Edit.


Password Protection

Add an optional password to any file:

  1. Click a file → Edit
  2. Enter a password in the "Password" field
  3. Click "Save"

Anyone accessing the file will be prompted for the password. Passwords are bcrypt-hashed server-side — we never see them in plain text.


Expiration Dates

Files can auto-delete on a schedule:

  • Set on upload or afterward via Edit
  • Specify a specific date or days from now
  • You'll receive an email reminder 2 days before deletion
  • Cancel anytime by removing the expiration date

Sharing

Click any file → Copy URL. The URL is immediately shareable.

Collaborators

Add specific people to a private file:

  1. Open file details → "Add Collaborator"
  2. Enter their email address
  3. Choose View (download only) or Edit (can modify metadata) permission
  4. They receive an email invite

Revoke access at any time from the collaborators list.

Edit Suggestions

Collaborators with View permission can submit edit suggestions (e.g., rename, change visibility) without directly modifying the file. You review and accept or reject each suggestion.


File Actions

ActionHow
DownloadClick file → Download original
DeleteClick file → Delete (permanent)
Edit metadataClick file → Edit
Copy URLClick file → Copy URL
View analyticsClick file → see download count and access log

Shared Files

Files shared with you by other users appear in Dashboard → Shared. You can download and (with edit permission) update metadata.


Chunked Uploads

Files too large for a single request are uploaded in chunks automatically by supported clients. The API also exposes chunked upload endpoints for custom integrations. See the Files API for details.


OCR (Text Extraction)

On Flare and Blaze plans, text is automatically extracted from image uploads:

  • Search files by their extracted text
  • Retrieve OCR results via GET /api/files/[id]/ocr
  • Processing triggers automatically on upload

On this page