How to use the Photos Repair Library tool on your Mac

If your Photos library won't open or if the Photos app behaves unexpectedly on your Mac, the Photos Repair Library tool may help.

Before you use the Photos Repair Library tool, back up your photo library. You can use Time Machine, use a third-party backup solution or copy the library to an external drive. By default, your photo library is stored in the Pictures folder within your home folder.

To get to the Photos Repair Library tool on your Mac, follow these steps: 

  1. If Photos is open, close the app. Then while you're clicking to open Photos, hold down the Command and Option keys at the same time.

  2. In the window that opens, click Repair to start the repair process. You may be asked to enter the password for your user account.

The Repair Library tool analyses the library's database and repairs any inconsistencies it detects. Depending on the size of your library, the repairs may take some time. When the process has finished, Photos will open the library.

If you're repairing a library that's used with iCloud Photos, iCloud will check the library after the repair process has completed to ensure everything has synced correctly.

If these steps don’t work or you can’t open the repair tool, contact Apple Support.

Information about products not manufactured by Apple, or independent websites not controlled or tested by Apple, is provided without recommendation or endorsement. Apple assumes no responsibility with regard to the selection, performance or use of third-party websites or products. Apple makes no representations regarding third-party website accuracy or reliability. Contact the vendor for additional information.

Published Date: