Smart Receipts
  • Features
  • Pricing
  • FAQ
Get started

Synchronizing Subscribed Folders the Right Way

August 27, 2026

Master synchronizing subscribed folders in your email client. Learn setup steps, fixes for stuck sync, and how Smart Receipts keeps backups seamless.

Synchronizing Subscribed Folders the Right Way
You've opened your mail client and found that a folder you need has vanished, a subscribed-folder sync appears frozen, or unread counts keep changing without the messages arriving. The instinct is to click refresh, but the deeper issue is usually server-side subscription metadata, local cache state, and the number of folders the client is trying to reconcile.
Synchronizing subscribed folders works best when you treat it as a controlled data pipeline. The server maintains the folder hierarchy and subscription list, the client maintains a local representation of selected folders, and downstream tools depend on that selection being accurate. A smaller, intentional sync set is usually more reliable than asking every device to mirror every mailbox.

What Synchronizing Subscribed Folders Actually Means

IMAP separates the folders that exist on the server from the folders a client has been told to monitor. The SUBSCRIBE command adds a mailbox to the subscribed set, while LSUB returns only that subscribed subset, as described in this IMAP folder subscription overview. Subscription doesn't itself transfer every message. It tells the client which folders belong in its working view and regular synchronization cycle.
notion image
During a refresh, the client compares its local cache with the selected mailbox. That cache typically tracks folder headers, message flags, and UID values, then uses server metadata to identify what changed instead of treating every message as new. UIDVALIDITY identifies the continuity of a mailbox's message identifiers, UIDNEXT indicates the next identifier the server expects to assign, and HIGHESTMODSEQ supports change tracking where the server offers that capability.

Subscription is not deletion

Unsubscribing hides a folder from the client's subscribed view. It doesn't delete the folder or its messages from the server. This distinction matters after migrations, account repairs, and device changes. A folder can exist in webmail while remaining invisible in a client that displays only subscribed folders.
Gmail can add another layer of confusion because labels and views such as All Mail don't always behave like conventional, independent IMAP folders. Treat the server's hierarchy as authoritative, query it when something appears missing, and then review the subscribed subset rather than assuming the local folder tree is complete.
This metadata-first model also explains why receipt backup systems need a dependable source set. If you're trying to organize your document library, the same principle applies: define which locations are active, preserve their structure, and avoid confusing visibility controls with data removal. Smart Receipts can use a subscribed mailbox as one source for receipt processing, so an incomplete subscription can affect what reaches a backup workflow.

Setting Up Subscribed Folder Sync in Outlook and Other Clients

Start with the server, not the local display. Open webmail or the provider's administration interface and confirm that the folders you need exist. Then use the client's subscription controls to query the current hierarchy before selecting anything.

Outlook desktop

In Outlook, open Account Settings, select the IMAP account, and review its account properties. Adjust the Synchronize Settings slider to control how much message content remains available locally, then use Send/Receive Groups to determine which folders participate in scheduled synchronization.
For folder visibility, right-click the IMAP account in the folder pane and choose IMAP Folders. Select Query to refresh the server folder list, then choose Subscribe for active folders or Unsubscribe for folders that shouldn't appear in the working tree. Outlook's own guidance describes this Query, Subscribe, and Unsubscribe workflow for controlling which IMAP folders appear and sync regularly (choose which IMAP account folders appear in Outlook).
notion image

Apple Mail

In Apple Mail, open the mailbox settings and review the IMAP mailbox mapping. Enabling Show IMAP Drafts/Mailboxes produces a clearer subscription tree, which helps distinguish server folders from local “On My Mac” mailboxes. If a folder isn't present, refresh the account's mailbox list before rebuilding the account.

Thunderbird and mobile clients

In Thunderbird, right-click the account or server entry and select Subscribe. Choose the folders that should appear, then enable the relevant offline setting if you need messages mirrored locally for travel or intermittent connectivity.
On iOS Mail, subscription behavior is broad by default, so review the folders shown under the account rather than assuming the active set is minimal. In the Gmail app, review All Labels and confirm that the labels or folders used for work are visible and included in the account's synchronization behavior.
Finish with a manual sync. Compare the folder structure and UID continuity on the server with what the client reports locally. If the folder appears, new messages arrive, and the local identifiers remain consistent after another refresh, the pipeline is wired correctly.

Why Subscribed Folders Get Stuck Syncing

A stuck status rarely points to one universal fault. The client may be waiting on a folder identity reset, processing a very large mailbox, rebuilding damaged offline data, or failing during an encrypted connection. Start by isolating the server folder state from the device cache.
Root Cause
Symptom
First Diagnostic Check
UIDVALIDITY change after a migration
The client starts downloading old headers again or appears to restart
Compare the mailbox identity before and after migration, then force a fresh folder query
Oversized folder
One folder stalls while smaller folders continue
Test the largest folder alone and review provider limits, including Gmail's 25 MB threshold and Outlook guidance that references 25–35 MB ranges
Excessive IDLE connections
Repeated reconnects, delayed updates, or intermittent folder status
Temporarily reduce concurrent clients and observe whether scheduled sync completes
Corrupt offline storage
The same folder fails after every restart
Create a controlled local cache rebuild or test the account in a clean profile
Corporate policy or MDM restriction
Settings revert or refreshes stop without a clear client error
Compare the affected device with an unmanaged test device
Antivirus TLS inspection
Authentication succeeds, but folder synchronization fails
Temporarily disable mailbox scanning under policy and test the encrypted session
Mailbox migrations deserve special attention. When the server changes UIDVALIDITY, the client can no longer trust its old UID cache and must re-establish message mappings. That can look like a network problem even when connectivity is stable.
A large folder can create a similar illusion. If the client spends its time reconciling old headers, flags, and attachments, the interface may report that subscribed-folder synchronization is stuck while the server is still responding. Before you troubleshoot slow internet, test a narrow folder set so you can distinguish bandwidth trouble from mailbox scale.

Designing the Right Sync Set for Real Performance Gains

The common assumption is that more subscribed folders produce a more complete mailbox. In practice, every additional folder gives the client more metadata, flags, and message state to reconcile. An archive that you rarely open can consume attention without improving your daily workflow.
notion image
Begin with the folders you actively triage: Inbox, Sent, one relevant archive, and shared project mailboxes. Disable global “All Folders” synchronization where the client offers that control, then add folders individually. Mailing-list archives and read-only collections should stay outside the active set unless a current process depends on them.
For low-priority mailboxes, a 30-day sync window can keep local data focused. A primary mailbox may warrant a 90-day window when recent history is needed offline. Those windows affect local availability, not server retention, so don't use them as a substitute for archiving or backup.
In Outlook desktop, review background synchronization choices and deselect folders that don't need offline access. In Apple Mail, review IMAP prefixes so the client queries the intended server hierarchy instead of maintaining unnecessary local metadata aliases. Keep push notifications for priority folders, and schedule a broader full sync periodically when older messages matter.
Measure the result with a stopwatch and a repeatable test, such as a 1,000-mailbox sync under three minutes. The value isn't the number alone. It's whether trimming the set produces a clear, repeatable improvement without hiding folders required for active work.

Comparing Sync Approaches Across Email and Cloud Storage

IMAP subscribed-folder synchronization is built around mailbox metadata. The client checks folder state, message flags, identifiers, and headers, then retrieves content according to its local settings. Latency tends to increase as the client has more folders and older message state to inspect.
Cloud storage systems optimize for a different object. A drive client treats a file as a unit whose content and metadata must remain intact, often using change tracking, hashing, or differential transfer. That makes cloud storage a better fit for archival receipt PDFs, while IMAP remains useful for search, tagging, conversation context, and server-side mail organization.
Sync Method
Best For
Latency Behavior
Cost Model
IMAP subscribed folders
Mail search, flags, folders, and conversation access
Depends on folder count, message history, and server responsiveness
Protocol traffic and local storage
Cloud file synchronization
Receipt images, PDFs, reports, and durable archives
Changes are handled as file operations and may be delayed by indexing or quotas
Storage, transfer, and API usage
Manual export and import
One-time moves or controlled records handoff
Fast for small sets, cumbersome for ongoing changes
Staff time and duplicate handling
The shared failure pattern is subscription drift. In email, stale folder identities or local lists can force a broad rescan. In cloud storage, stale change state can trigger renewed file inspection. In both cases, the system loses the narrow path between “what I already know” and “what changed.”
For teams trying to streamline email with NotionSender, keep the roles separate. Use folder sync for active mail handling, and use cloud storage for durable receipt files and reports. When the same receipt exists in both places, decide which system is authoritative before troubleshooting duplicate or delayed copies.

How Smart Receipts Keeps Receipt Backups Synced

A receipt backup workflow depends on more than whether an email folder is visible. The system needs a stable source mailbox, a reliable folder subscription, and a way to distinguish a newly received attachment from one it has already processed.
notion image
Smart Receipts connects to the IMAP mailbox selected during onboarding and watches that subscribed source for receipt messages. It treats each receipt as a discrete object, with attachment identity, vendor information, and folder lineage kept separate from the mail client's read and unread display state. The service performs a delta pass every six hours for new messages with image or PDF attachments, then hashes those attachments before sending them to its encrypted backup bucket.
The mobile workflow handles a different path. When a receipt is photographed offline, the app holds it until connectivity returns, then uses an IDLE push listener to begin the handoff. Metadata and file content are handled separately, so a mailbox can reflect changed read or unread flags while the receipt binary continues uploading asynchronously.
If a transfer fails, Smart Receipts queues the attachment hash and retries with exponential backoff for up to 72 hours. When retries don't resolve the issue, the dashboard surfaces a Resync action rather than treating the item as complete. This separation makes the subscription list important: the backup process can only inspect the mailbox and folders that form its configured source set.
A focused set, such as Inbox plus a dedicated Receipts folder, reduces unnecessary scanning and keeps receipt processing easier to audit. For the capture side of the workflow, the guide on the best way to scan receipts covers how to create cleaner source material before synchronization begins.

Troubleshooting Checklist for Persistent Sync Failures

Persistent failures need a sequence, not repeated refreshes. Start at the server and work toward the device so you don't rebuild a local profile while the account itself is refusing folder queries.
notion image
  1. Verify server IMAP. Confirm IMAP is enabled and that webmail shows the expected folders. Check the server-side subscription state before changing the client.
  1. Check the connection. Confirm the client uses port 993 with TLS. Re-enter credentials, and investigate any silent fallback to port 143. If MFA is active, use the provider's supported app-specific password process where required.
  1. Test the subscription. Query the folder list, unsubscribe from the problem folder, and subscribe again. Check mailbox quota and server rules that may automatically move messages elsewhere, making a delivery problem look like a sync problem.
  1. Clear local state. In Outlook, use the account's data-file settings to inspect or rebuild the offline IMAP cache. In Apple Mail, remove the local .OfflineCache data when appropriate. In Thunderbird, reset msgCache.db only after preserving any local-only mail.
Antivirus mailbox scanning can interrupt TLS negotiation during synchronization. Disable that inspection temporarily under your organization's policy, then test DNS resolution and confirm that no corporate proxy is rewriting certificate chains. On mobile, force-stop the app, clear its storage where supported, and authenticate again.
Document each action and result before escalating to the mail host or Smart Receipts support. The Smart Receipts server connection guide can help confirm the account-side setup before you remove and re-add the account.
Smart Receipts backs up receipt images, expenses, categories, and settings to connected cloud storage while keeping receipt records accessible across devices. Review your subscribed folders, narrow the source set to the mailboxes you use, and then visit Smart Receipts to connect your receipt workflow and protect the records that matter.

Ready to simplify your expense tracking?

Download Smart Receipts and start managing your receipts today.

Get Started
© 2026 SmartReceipts. All rights reserved.
AboutLog InFeaturesBlogTerms of UsePrivacySupport