
Apple documents Repair Library as a way to rebuild a problematic Photos library, with a backup required first. Follow its repair instructions after identifying the actual library and symptom. An empty collection caused by opening another library is a different problem from a damaged database.
Write down the failure
Record what happens when Photos opens, the exact message if present, the library location, and whether the storage device is available. Note when the library last worked. This record makes it possible to distinguish a continuing failure from a new outcome after repair.
If the library is on an external disk, confirm that the disk and the expected library are accessible. Do not erase, reformat, or rearrange the package as an experiment. The repair route is not a substitute for selecting the right collection.
Protect a recoverable state
Apple explicitly says to back up the library before repairing it. Confirm the backup location and that the copy you intend to retain is separate from the working library. A sync status alone does not establish an independent rollback point; see cloud sync versus backup.
Record any originals stored outside the library as well. Those files need their own coverage rather than an assumption that one library package contains every source.
Use the documented repair entry
Quit Photos. Apple's Mac procedure uses Option-Command while opening Photos, then Repair in the Repair Library window. Read the displayed target and instructions before starting. Do not repeatedly alternate repair attempts and manual package edits without keeping track of the state.
The procedure rebuilds the library. It is not an official promise that every missing file, unavailable disk, or unsupported media type will become available.
Verify the original symptom
After completion, repeat the same bounded check: open the affected picture, locate the known album, or reproduce the operation that failed. Check a few known edits and source items as well. Preserve an accepted-version record before new editing work changes the evidence.
If the problem persists, Apple points to restoring a library from Time Machine as another route. Investigate that route's cloud implications before proceeding. This article describes the official workflow and preparation; it does not diagnose corruption, perform a repair, or claim that a particular library has been recovered.
Related tasks
- Does Deleting a Phone Photo Also Delete the iCloud Original?
- How Do I Keep the Approved AI Image or Video from Getting Lost Among Revisions?
Sources and scope
- Repair your photo library on Mac: Backup requirement, quit/Option-Command/Repair procedure, rebuild behavior and Time Machine fallback.
Prepared by Imagild Editorial, the company editorial team responsible for these guides. AI assisted research and drafting. This is documentation-based guidance, not a claim of hands-on testing or independent review. Report a correction.
Cover: Pignatta / Pixabay, Content License. The city photograph is an illustrative source asset; it does not show this application or a test result.