How to Fix ‘Setting Up Your Library’ Stuck in Google Photos

Opening Google Photos on Android or iOS only to see a permanent spinning progress circle displaying ‘Setting up your library’ or ‘Getting your photos’ prevents access to your cloud media. When this initialization hangs, local thumbnails fail to render, search indexing pauses, and recent camera roll captures are blocked from uploading to Google cloud storage. This issue occurs when Google Photos’ local SQLite database encounters schema lockups, when background media scan services in Android Media Storage crash on a corrupt image container, or when account authentication tokens become out of synchronisation with Google Play Services.

Why Does Google Photos Get Stuck on Setting Up Your Library?

The library initialization process validates local device media against cloud metadata catalogs. The lockup is driven by:

  • Corrupted Local SQLite Database: The application’s internal metadata index becoming damaged due to an ungraceful OS termination or low storage space.
  • Media Storage Indexing Deadlocks: Android’s underlying Media Storage provider freezing when attempting to generate EXIF thumbnails for corrupted zero-byte video or image files.
  • Google Play Services Sync Lockout: Stale OAuth credentials preventing Google Photos from securing read access to Google Cloud servers.
  • Battery Optimization Throttling: Aggressive system power management terminating the background scanning thread before initial handshake completion.

Step 1: Force Stop and Clear Google Photos Cache & Data

Resetting the local application cache forces Google Photos to rebuild a clean index without deleting any photos stored on your device or in the cloud.

  1. Open Settings on your Android smartphone.
  2. Navigate to Apps (or Apps & Notifications) > See all apps.
  3. Scroll down and select Google Photos (or Photos).
  4. Tap Force Stop and confirm by tapping OK.
  5. Tap Storage & cache.
  6. Tap Clear Cache, then tap Clear Storage (or Clear Data).
  7. Reopen Google Photos. Sign in, keep the app open in the foreground on active Wi-Fi, and allow the library to re-index.

Step 2: Clear Data for Android Media Storage System Service

If Android’s internal media catalog is corrupted, Google Photos inherits the file system freeze.

  1. Go to Settings > Apps.
  2. Tap the three dots in the top-right corner and select Show system apps.
  3. Locate and tap Media Storage.
  4. Tap Storage & cache > Clear Storage.
  5. Restart your smartphone. The operating system will automatically rebuild the media index over the next 5 to 10 minutes.

Step 3: Disconnect and Re-Add Your Google Account

Refreshed authentication tokens clear server-side synchronization roadblocks.

  1. Open Settings > Passwords & accounts (or Users & accounts).
  2. Select your Google Account.
  3. Tap Remove account and confirm the prompt.
  4. Restart your device.
  5. Return to Settings > Accounts, tap Add account > Google, and sign in again.
  6. Launch Google Photos to initiate a clean account handshake.

Step 4: Check for Corrupted Media Files on Storage

A single corrupt video or incomplete download in your DCIM or Download directory can halt the scanner thread.

  1. Open your device’s Files or file manager app.
  2. Navigate to Internal Storage > DCIM > Camera and Downloads.
  3. Sort files by size or check for files showing 0 B or displaying broken, grey thumbnail icons.
  4. Move suspect zero-byte files or unsupported formats to a separate temporary folder or delete them.
  5. Re-open Google Photos to let indexing proceed past the stalled file.

Step 5: Disable Battery Restrictions for Photos

Ensure the operating system does not kill the indexing process when the screen turns off.

  1. Go to Settings > Apps > Photos > App battery usage.
  2. Change the setting from Optimized to Unrestricted.
  3. Ensure background data usage is enabled under Mobile data & Wi-Fi.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.