Troubleshooting
Bluesky authentication problems
Fix Bluesky connection issues: app-password mistakes, handle mismatches, and expired sessions.
Last updated June 14, 2026
Bluesky auth issues almost always trace back to the app password or a handle mismatch between the credential and the identity. Work through the cases below in order before reconnecting from scratch.
Troubleshooting
- "credentials missing".
- The app password was blank. Generate a new app password in Bluesky settings and paste it.
- Handle mismatch warning.
- The credential resolved to a different account than the identity's handle. Fix the handle or reconnect with the right account's app password.
- Publishing started failing after working.
- The session may have expired or the app password was revoked in Bluesky. Reconnect to refresh it.