Notifications, Sync, and Offline Use

SwiftMail syncs Gmail into local storage and uses the local cache for reading already-synced mail.

Notifications

After sign-in, SwiftMail asks macOS for notification permission. When permission is granted, new mail can appear as a macOS notification with the sender and subject.

Notification actions include:

• Mark as Read
• Archive

Clicking a regular new-mail notification opens the related thread. Regular new-mail banners are suppressed while SwiftMail is in the foreground.

Verification code notifications offer Copy Code and can appear even while SwiftMail is open. See Verification Codes for details.

Dock badge

The app updates the Dock badge with the unread Inbox message count for the active account. The badge is cleared when that count reaches zero.

Sync

SwiftMail performs:

• A full sync after sign-in, account switch, or account add.
• Partial refreshes approximately every three minutes while the app is open.
• Manual refresh from message lists.
• On-demand label and draft sync.

The refresh toolbar button appears on the first page of a message list. Press Command-R to refresh.

Pagination

Large message lists are split into pages. Use the left and right page controls in the toolbar to move between pages. If the next page has not been fetched yet, SwiftMail loads it from Gmail.

Offline banner

When the Mac has no network connection, SwiftMail shows a red No Internet Connection banner at the bottom of the window.

Already-synced messages remain available from the local cache, but actions that require Gmail may fail until the connection returns.