How to Increase IMAP Folder Limits

Desktop email clients and mail migration tools can slow down, freeze, or drop connections when working with large mailboxes. This behavior often stems from hard limits on IMAP folders: either a client-side cap on how many messages can sync locally, a server-side cap on total folders (labels), or account bandwidth limits.

Quick Answer

Gmail does not allow users to increase server-side IMAP folder limits beyond its hard architecture caps. However, you can prevent folder-limit errors by adjusting client-side sync settings. In Gmail’s web interface under Forwarding and POP/IMAP, set Folder size limits to cap visible messages (e.g., 1,000 or 5,000 messages), or uncheck Show in IMAP for high-volume labels.

---

Understanding IMAP Folder Caps

When discussing “IMAP folder limits” in Gmail and Google Workspace, administrators and users typically encounter three distinct constraints:

1. Per-Folder Message Count Caps (Client Sync Throttle): A Gmail setting that controls how many recent messages in each label are exposed to desktop clients over IMAP (1,000, 2,000, 5,000, or 10,000).
2. Total Label Count Caps (Server Architecture): Google supports a maximum of approximately 500 labels (folders) per account. Exceeding this threshold causes severe synchronization lag, socket drops, and client application crashes.
3. Bandwidth Throttling Limits: Google enforces daily transfer ceilings for IMAP connections (2.5 GB/day download and 500 MB/day upload). Pushing large folders past these thresholds temporarily locks the IMAP interface.

---

Step-by-Step: Adjusting IMAP Folder Limits in Gmail

You can manage how many messages your email client synchronizes by adjusting folder limits in Gmail’s web settings:

Step 1: Access Gmail Forwarding and POP/IMAP Settings

1. Open Gmail in your web browser.
2. Click the Gear icon in the top right corner and select See all settings.
3. Select the Forwarding and POP/IMAP tab.

Step 2: Configure Folder Size Limits

1. Scroll down to the IMAP access section.
2. Look for the Folder size limits option.
3. You will see two choices:
   • Do not limit the number of messages in an IMAP folder (default)
   • Limit IMAP folders to contain no more than this many messages
4. Select Limit IMAP folders to contain no more than this many messages and choose a threshold: 1,000, 2,000, 5,000, or 10,000.
5. Click Save Changes at the bottom of the page.

IMAP Settings
├── Do not limit (Default) ────► Syncs entire history. Causes high memory use and slow indexing.
└── Limit to 1,000–10,000 ─────► Syncs only newest items. Reduces local cache size and improves sync speed.

---

Modifying Local Storage Limits in Desktop Clients

If your goal is to download more mail for offline search in Microsoft Outlook or Mozilla Thunderbird, configure your client-side caching settings:

In Microsoft Outlook (Exchange / IMAP Slider)

1. Open Outlook and go to File > Account Settings > Account Settings.
2. Double-click your email account.
3. Locate the slider labeled Download email for the past:.
4. Move the slider from its default (typically 3 months or 1 year) to All if you need offline access to your entire archive, or reduce it to 1 month if Outlook is freezing under the weight of large folders.
5. Click Next, then Finish, and restart Outlook.

In Mozilla Thunderbird

1. Go to Tools > Account Settings (or click the hamburger menu and select Account Settings).
2. Under your account, click Synchronization & Storage.
3. Under Message Synchronizing, check Keep messages in all folders for this account on this computer.
4. To avoid downloading massive individual messages that exceed folder limits, check Synchronize all messages locally regardless of age, but set Don’t download messages larger than [X] KB (e.g., 20,000 KB).

---

Managing Label Overload (Exceeding the 500-Folder Limit)

If you migrate an email environment with deep folder structures (such as an old Exchange or cPanel server), you may easily exceed Google’s recommended cap of 500 labels.

To prevent connection drops:

1. Navigate to Gmail Settings > Labels.
2. Review your labels and uncheck Show in IMAP for any archival, vendor, or project folders you do not need in your desktop client.
3. Ensure All Mail and Trash are unchecked under Show in IMAP to keep your desktop client from building oversized cache databases.

If your mail client continues to hang during startup or status checks, consult Why Gmail IMAP is Stuck on “Syncing Subscribed Folders”.