Troubleshooting

Something not working? Here are solutions to common issues.

App Won't Load

Web

1. Hard refresh: Ctrl/Cmd + Shift + R
2. Clear browser cache for spudsuite.com
3. Try a different browser
4. Disable browser extensions temporarily

Desktop (macOS/Windows/Linux)

1. Quit and reopen the app
2. Restart your computer
3. Reinstall SpudSuite (your data is preserved)

Android

1. Force stop the app and reopen
2. Clear app cache (Settings then Apps then SpudSuite then Clear Cache)
3. Reinstall the app

Sync Not Working

Check basics first

• Is your internet connection working?
• Is cloud sync connected? (Check Settings)
• Do you have storage space in your cloud account?

Try these fixes

1. Click the sync icon to force manual sync
2. Disconnect and reconnect your cloud provider
3. Sign out and back into your Google/Dropbox account

"Access denied" or "Token expired"

OAuth tokens expire periodically. Fix it by:

1. Go to Settings
2. Disconnect your cloud provider
3. Reconnect and re-authorize

Notes Missing

Check these places

• Wrong folder? Check the "All Notes" view
• Filtered out? Clear any tag filters
• Search active? Clear the search bar
• In a project? Project-owned notes may show with a project prefix — check your projects
• Different device? Make sure sync is working

Recover from cloud

If notes exist in your cloud but not locally:

1. Disconnect cloud sync
2. Clear local data (Settings then Advanced then Clear Local Data)
3. Reconnect cloud sync
4. Notes will download from cloud

Sync Conflicts

If you edit the same item on two devices before they sync:

1. A yellow conflict banner appears
2. Click the banner to see both versions
3. Choose which version to keep (or merge manually)

To prevent conflicts:

• Wait for sync to complete before editing on another device
• Check the sync icon shows "up to date" before closing the app

Slow Performance

Web

• Clear browser cache
• Disable heavy browser extensions
• Try Chrome or Firefox (usually fastest)

Desktop

• Close and reopen the app
• Check if background processes are using resources
• Make sure you have enough RAM available

With many notes (1000+)

• Use folders to organize and reduce the visible note list
• Archive old notes you don't need
• Search is optimized, but very large libraries may feel slower when loading

Can't Connect Cloud Provider

Pop-up blocked

The OAuth authorization window may be blocked by your browser. Allow pop-ups for spudsuite.com and try again.

Wrong account

If you're signed into multiple accounts (Google, Dropbox), make sure you're authorizing the right one.

"This app isn't verified" warning (Google)

Google may show this for some apps. Click "Advanced" then "Go to SpudSuite (unsafe)" — it's safe, just not fully verified by Google yet.

Pro Not Working

Purchased but no Pro features?

1. Make sure you're using the same browser/device you purchased on
2. Try refreshing or reopening the app
3. Check Settings for your subscription status
4. If you have cloud sync enabled, Pro status should sync across devices
5. If still not working, email support@spudsuite.com with your receipt

Reset Everything

As a last resort, you can start fresh:

Web

1. Clear all site data for spudsuite.com in browser settings
2. Reload the page

Desktop

1. Uninstall SpudSuite
2. Delete the data folder:
   • macOS: ~/Library/Application Support/SpudSuite
   • Windows: %APPDATA%/SpudSuite
   • Linux: ~/.config/SpudSuite
3. Reinstall

Android

1. Settings then Apps then SpudSuite then Clear Data
2. Or uninstall and reinstall

Still Stuck?

Email us at support@spudsuite.com with:

• What you're trying to do
• What's happening instead
• Platform (web/macOS/Windows/Linux/Android/iOS)
• Browser (if web)
• Any error messages

We usually respond within 24 hours. Pro members get priority support.