Preservation packages
Library care: keep every photo present, undamaged and duplicate-free Watch on YouTube
A preservation package is an independent copy of your original files together with everything your library knows about them. Every file is checksummed when it’s written and can be checked again at any time, so years later you can prove the copy is intact. Restore a package into your library, on this server or another one.
Find it in Settings, then Import & export, then Export a copy.
What’s in a package
Section titled “What’s in a package”- your original files
- dates, places, your descriptions, ratings, favourites and archive
- Locked records, with the reason each item was locked
- albums and collections, tags, and named people
- edit recipes, so edited versions can be made again
- Live Photo and stack links
- document corrections and moment notes
Only your own items are ever included, never a partner’s or a shared album’s. Copies a partner shared with you are your own items, so they’re included.
Make a package
Section titled “Make a package”- Choose Export a copy….
- Include. Under What to preserve, choose Whole library, Favorites, Dates (a range of dates the photos were taken), Albums, or Search, which takes the same words and filters you use in Search, such as
person:oryear:. To preserve a hand-picked set, such as smart search results, select the items and choose Export for preservation… from the selection bar.- Include metadata and edit recipes adds the metadata files, albums, people, tags and edit recipes.
- Include checksums and a manifest is always on.
- Include Locked items is only available while your session is unlocked.
- Verify. The server counts and measures your selection and checks that it fits in one package, up to 100,000 items, and in the free space where packages are written. Nothing is written yet.
- Manifest. See what the package will hold and, category by category, what a restore brings back.
- Choose Start export.
The export runs in the background and is listed in Activity and in the package list. Closing the page doesn’t stop it. You can pause, resume or cancel it, and a paused export carries on from the next item. A cancelled or failed export stays in the package’s Manage window, with Retry to run it again.
Each original is copied into the package and checked against the checksum your library recorded for it. Nothing is moved or linked, and your library’s files are never changed.
An item that fails is tried once more automatically. Anything still failing is listed in the item report, where Retry failed items tries again. A package whose items didn’t all copy is marked Incomplete.
If an item becomes Locked after you started an export without Locked items, it’s skipped.
Export an album
Section titled “Export an album”To preserve a single album, open it, choose More actions (…) and then Export originals and metadata…. It’s on albums you own, but not on collections or Locked albums, and it’s unavailable while the album is empty.
The export covers just that album: your originals in it, with their metadata and sidecars. Locked items are always left out, so Include Locked items isn’t offered, and Include metadata and edit recipes is always on. The package is named after the album unless you give it another name. Then Verify, Manifest and Start export work as above.
When the export starts, Photos opens the package so you can follow it, cancel it, and check it once it’s written. To keep the package on a drive of your own, see Save it to a drive with Frameleaf Desktop.
Verify a package
Section titled “Verify a package”In the package’s Manage window, Check again reads the package back: the manifest first, then every original and metadata file against its SHA-256 checksum. The package then shows when it was checked and a count such as 12 match · 0 missing · 0 changed · 0 unexpected, where unexpected files are ones the manifest doesn’t account for. A package this server wrote is also compared with the record the server kept when writing it, so a rewritten manifest is reported as changed rather than believed.
A package is Not verified until a verification passes. Verify the copy you keep elsewhere too, by uploading it, or, if you’re an administrator, by pointing the server at it. Then you know the copy you’re relying on is intact, not just the one on the server.
Download a package
Section titled “Download a package”In the package’s Manage window:
- Download saves the whole package as one ZIP file, named like
name.frameleaf-preservation.zip. - Download the checklist, under More, saves just its manifest.
A package that holds Locked items can only be downloaded while your session is unlocked. While you’re locked, Locked items are left out of the item report, the restore review and every count.
Save it to a drive with Frameleaf Desktop
Section titled “Save it to a drive with Frameleaf Desktop”Frameleaf Desktop can save a verified package straight to a drive connected to your computer, such as an external disk. It checks every original and metadata file against the package’s manifest as it saves, and never replaces a file already on the drive. In Desktop, open Backups, choose Load verified packages under External media copy, then Save verified copy… next to the package.
Only complete packages that show Verified and hold no Locked items can be saved this way, so choose Check again first. See Save a preservation copy to a drive.
Restore from a package
Section titled “Restore from a package”Under Restore from an exported copy, choose A copy on this server or A copy on my computer, or choose Restore… in a package’s Manage window. A restore has four steps.
- Package. Pick a package this server wrote, upload a package ZIP (kept for three days), or, if you’re an administrator, name a package folder or ZIP on the server outside its media storage. Choose whether to restore edit recipes, and what should happen where the package and your library disagree.
- Check. Every file is verified against the manifest and each original is compared with your library. Nothing is written.
- Review. Each original is shown as new to your library, already in your library or in your trash. For originals you already have, the details that differ (date taken, description, location, rating, archive, edit recipe) are listed side by side. Choose Keep library or Use package for each, or leave the default.
- Restore. The originals your library doesn’t have are added, and the ones it has are matched.
Download reconciliation report saves a list of every item in the restore and what happened to it.
What a restore never does
Section titled “What a restore never does”- Replace or duplicate an original. Originals are matched by checksum. One already in your library is never replaced or copied twice. One in your trash isn’t added again: restore it from the trash first, then run the restore again.
- Remove anything. A favourite or Locked record in the package is added, but a restore never clears a favourite or unlocks anything. Locked items come back Locked, with the reason they were locked.
- Undo your later changes. Your choices apply to items not yet restored. A restore that’s paused, cancelled or interrupted carries on from the items it hadn’t finished, and never touches an item it already restored.
- Create things twice. Albums, collections and people in the package are found again on a repeated restore: the original album if it’s still yours, one an earlier restore created, or your only album with the same name in the same place. New ones are only created when none of those exists.
Collections stay at the top level, and albums sit inside a collection one level deep.
What comes back
Section titled “What comes back”| Information | After a restore |
|---|---|
| Original files, dates, places, your descriptions, ratings, favourites, archive, Locked records, albums and collections, tags, named people, edit recipes, Live Photos, stacks | Restored |
| Document corrections, moment notes and transcripts | Restored where your library has none of its own |
| Generated descriptions and moment captions, model and enrichment details, camera details | Kept as provenance only |
| Sharing and shared spaces, pets, memories, Studio projects | Not included |
Generated text is never restored as yours. A description a model generated is kept with the restored item as a record, not written as your own description. Camera details come back from the original file itself when it’s read.
Edited versions are made again from their recipes once the originals have been read. Unnamed faces are detected again, and named people come back on their faces.
The package format
Section titled “The package format”A package is plain files you can inspect:
| Path | Contents |
|---|---|
manifest.json |
Format and version, package ID and name, what was selected, counts, completeness, restore support, and a SHA-256 checksum for every index file |
assets.jsonl |
One line per original: its paths, size, SHA-1 and SHA-256 checksums, and the checksum of its metadata file |
albums.json, people.json, tags.json |
The albums and collections, named people and tags the originals belong to |
originals/<id>.<ext> |
The original files |
metadata/<id>.json |
One metadata file per original |
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.
