Troubleshooting

Sign-in fails

Try signing in again and confirm that you allowed the requested Google access. If Google reports that the app is blocked or its authorization configuration is invalid, report the message to the app developer.

Sync failed

If a message list shows Sync Failed, click Retry.

If sync continues to fail:

• Check your internet connection.
• Confirm the Gmail account is still connected in Settings.
• Switch accounts and switch back to force a fresh account sync.

No messages appear

If a label shows No Messages, use the refresh toolbar button or press Command-R. Some labels only load when opened.

For search, confirm whether Include Spam & Trash should be enabled.

Actions fail

If Archive, Trash, Spam, Labels, or other Gmail actions fail, SwiftMail shows an Action Failed alert. Check your connection and retry the action.

Attachment download fails

Choose a writable folder when prompted. If another attachment download is waiting for folder selection, finish or cancel that selection before starting another download.

Compose send or save fails

SwiftMail shows Send Failed or Save Failed with the underlying error. Check that the account is connected and that the Mac is online, then try again.

Offline mode

When No Internet Connection appears, already-synced messages can still be read from the local cache. New syncs, sends, downloads, and Gmail actions need the connection to return.

Copy Code is missing or notifications are delayed

Confirm Verification code notifications is enabled in SwiftMail Settings and the email is unread and in the active account’s Inbox. Refresh the inbox to check for new mail; automatic refresh runs approximately every three minutes.

If the inbox button appears but an alert does not, check SwiftMail’s macOS notification settings, Focus, and notification behavior during screen sharing. You can still copy from the inbox. Not every code format is recognized; see Verification Codes.