Uploads and downloads
Upload whole folders with the Frameleaf CLI: API keys, dry run and albums Watch on YouTube
Add photos from your computer and take them back out whenever you like. The web app handles both through two panels, Uploads and Downloads, which sit in the bottom corner of the window and stay on screen while you keep browsing. Minimise them when you want more room.
For backing up a phone, use the iPhone and Android apps. For moving a whole library from another service, see Migrate. To save pictures and pages you find on the web, use the Save to Frameleaf browser extension, which saves into Boards.
Upload
Section titled “Upload”- Select Upload in the top bar.
- Choose files or a folder, and optionally an album to put them in.
You can also drag files onto a library page, or choose Upload from computer inside an album.
Each file gets a row with its size and state:
| State | Meaning |
|---|---|
| Waiting | In the queue |
| Uploading | On its way, with a percentage |
| Uploaded | In your library |
| Already in your library | An identical file is already there. It’s recognised by its content and not stored twice. If the one in your library has lost its file, or its file is damaged, your upload is put in its place instead; see Uploading or importing the photo again |
| Error | The upload failed, with the reason |
From the panel you can:
- Retry failed to upload the failed files again, to the same album or to Locked if that’s where they were going.
- Cancel remaining to stop the files still waiting or on their way. Files already uploaded stay.
- Clear finished to remove the uploaded and duplicate rows while the rest carry on.
Uploads keep going while you move between pages of the app, so you can carry on browsing. New photos can appear in your library before their thumbnails are ready; they fill in by themselves. To follow a large import, see Activity.
Upload straight into Locked
Section titled “Upload straight into Locked”Upload into Locked and new photos are hidden from the moment they arrive. See Locked and private content.
Sidecar files
Section titled “Sidecar files”Choose photos and their matching .xmp files together, or choose the folder that contains both. Frameleaf attaches each sidecar to its photo and reads its details; the sidecar does not become a separate library item. Unmatched sidecars are reported. The command-line tool also finds sidecars beside photos. See Attach a sidecar for naming, size limits and replacing one later.
If you reload or close the tab
Section titled “If you reload or close the tab”Keep the tab open until your upload finishes. Reloading or closing it stops the files still waiting or on their way, and the panel starts empty afterwards.
Files that finished uploading are safely in your library. To finish the rest, simply upload the same files again: Frameleaf recognises the ones already there and skips them.
Download
Section titled “Download”- Download a single item to get its current version, which is the edited version if you’ve edited it.
- Download original gets the untouched file of an edited item. In the viewer, open More actions to find it.
- Several items, an album or a whole view download as zip archives. An archive bigger than your size limit is split into several parts, each with its own row.
- The short video that belongs to a Live Photo or a motion photo comes with it when you turn on Include the short video with Live Photos and motion photos.
Each row shows what’s being prepared, then Save. A failed row offers Retry, and Cancel stops a download that’s still being prepared.
A prepared download lives in the tab you started it in, so save it before you reload.
Download settings
Section titled “Download settings”Go to Settings, then Your preferences, then Downloads. Changes wait for the Save bar.
| Setting | What it does | Default |
|---|---|---|
| Include the short video with Live Photos and motion photos | Downloads get the moving part as well as the still | Off |
| Add a details file beside each photo | Adds a small file with the date, place and tags. The photo itself is not changed | On |
| Split big downloads into files of | Large downloads arrive as several zip files of this size, so one interrupted file doesn’t cost you the rest. Choose 2 GB, 4 GB (recommended), 10 GB or Custom, from 1 to 100 GB | 4 GB |
See Downloads.
What you can download
Section titled “What you can download”The panels list only what you’re allowed to download:
- A Locked item is downloaded or named only after you unlock your session.
- A shared link offers downloads when its owner turns on Allow download.
- Locking your session or signing out clears both panels.
Send a copy
Section titled “Send a copy”To hand a photo straight to another app on your phone or computer, open it in the viewer and choose Send a copy…. It uses your device’s share sheet, up to 50 items and 500 MB at a time.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.
