Cloud Storage Troubleshooting Guide

Solutions for common issues when connecting or using Google Drive and OneDrive with The Berean.

Quick Fixes

Try These First

  1. Refresh the page and try again
  2. Clear browser cookies and cache
  3. Try a different browser
  4. Disconnect and reconnect the cloud service
  5. Check your internet connection

Connection Issues

"Not connected" when I already connected

Symptoms: Dashboard shows "Connect" button even though you previously connected.
Possible Causes:
  • OAuth token expired (tokens last 1 hour for Google, varies for Microsoft)
  • You revoked access from your Google/Microsoft account settings
  • Browser cookies were cleared
Solution: Click "Connect" again to refresh your authorization. This is normal and doesn't affect your saved reports.

Connection popup closes immediately

Symptoms: Popup window opens then closes without completing sign-in.
Solution:
  1. Disable popup blockers for this site
  2. Check if you have multiple Google/Microsoft accounts signed in - sign out of extras
  3. Try incognito/private browsing mode

"Admin approval required" (Microsoft/OneDrive)

Symptoms: Microsoft shows a message saying your admin must approve the app.
Solution:
  • Work/School accounts: Contact your IT administrator to approve The Berean
  • Alternative: Use a personal Microsoft account instead

Saving Reports Issues

"Permissions need to be updated"

Symptoms: Error appears when trying to save a report to Google Drive.
Cause: You connected your account before we added the "save to cloud" feature, so your connection only has read permissions.
Solution:
  1. Go to Dashboard > Cloud Storage
  2. Click "Disconnect" next to Google Drive
  3. Click "Connect" to reconnect with updated permissions
  4. When Google asks for permissions, make sure to allow file creation

Report saves but I can't find it

Symptoms: Success message appears but file isn't visible in cloud storage.
Solution:
  • Reports are saved to a folder called "Berean Reports"
  • Check the root of your Drive/OneDrive for this folder
  • Search for "berean-analysis" in your cloud storage
  • Wait 30 seconds and refresh - sync can take a moment

"Failed to save" error

Symptoms: Generic error when attempting to save.
Solution:
  1. Check if your cloud storage is full
  2. Verify your internet connection is stable
  3. Disconnect and reconnect the cloud service
  4. Try the "Download PDF" option as an alternative

Analyzing Cloud Files Issues

Can't see my files in the file browser

Symptoms: File list is empty or doesn't show expected files.
Solution:
  • Only PDF, DOCX, and TXT files are shown (these are the supported formats)
  • For Google Docs, they appear as Google Docs format - we'll convert them
  • Check if files are in a subfolder - navigate into folders to find them

"Unsupported file type" error

Symptoms: Error when trying to analyze a cloud file.
Supported file types:
  • PDF: Standard PDF documents
  • DOCX: Microsoft Word documents
  • TXT: Plain text files
  • Google Docs: Native Google documents (auto-converted)

Not supported: Images, spreadsheets, presentations, audio, video

Mobile/PWA Issues

Cloud save doesn't work on mobile

Symptoms: Feature works on desktop but fails on phone/tablet.
Solution:
  1. Make sure you're using the same account on mobile as desktop
  2. Cloud connections are per-account, so connecting on desktop connects on mobile too
  3. If using the PWA, try accessing through the browser instead
  4. Check if your mobile browser is blocking popups

Security & Privacy

What permissions does The Berean have?

Google Drive drive.file - Can only access files The Berean creates or that you explicitly open with us
OneDrive Files.ReadWrite.All - Can read/write files (needed for both analyzing and saving)

How to revoke access completely

Still Need Help?

If you've tried the solutions above and still have issues:

  1. Note the exact error message you see
  2. Note which cloud service (Google or Microsoft) and browser you're using
  3. Contact us at support@faithguard.ai