Gmail App 'Days of Mail to Sync': What the Setting Does

The short answer
Days of Mail to Sync is a Gmail Android setting that controls how many days of email are stored on your device for offline access. It does not limit what you can see online — older mail is always accessible with an internet connection. Raising the number gives more offline reach; lowering it frees storage.
Gmail's 'Days of Mail to Sync' controls offline email storage on Android. Here's what it does, how to change it, and when to raise or lower it.
On this page
If the Gmail Android app stops showing mail beyond a certain date, you have run into the 'Days of Mail to Sync' setting. It is not a cap on your account — every email you have ever received is still on Google's servers. What it controls is how much of that mail gets downloaded to your phone so you can read it without an internet connection.
The default is 30 days. Gmail stores roughly a month of messages in local storage. If you go offline — on a flight, underground, in a dead zone — those messages are readable. Anything older than 30 days is not stored on the device. The moment you get back online, you can search and open any message in your account regardless of age.
This guide explains exactly what the gmail app days of mail to sync setting does, how to change it on Android step by step, why iOS and the Gmail website work differently, and what to do when the change does not seem to take effect.
Before you start#
The Days of Mail to Sync setting lives inside the Gmail Android app only. It does not appear in the iOS Gmail app or in Gmail on any browser. If you are on an iPhone, skip to the platform differences section — the iOS app does not expose this control to users.
The setting is also per-account. If you have multiple Gmail or Google Workspace addresses set up in the same app, each one has its own sync window. Changing the setting for one address does not change it for the others. Identify which address is missing the older mail before you open Settings.
Make sure your Gmail app is current. Very old versions of the app placed the setting under a slightly different path, and a handful of Android builds on custom ROMs omit it entirely. If you cannot find it after following the steps below, update Gmail from the Play Store and try again.
Android only — skip to platform differences if you are on iOS
How to change Days of Mail to Sync on Android#
The setting is in Gmail's per-account preferences, not in Android's system settings. Follow these steps — it takes under two minutes once you know where to look.
- 1
Open Gmail and go to Settings
Tap the three-line menu (hamburger icon) in the top-left corner of the Gmail app, then scroll down and tap Settings. On some Android builds you will see a gear icon in the upper-right instead — either path takes you to the same screen.
- 2
Select the account you want to adjust
If you manage more than one address in the app, each one is listed here. Tap the specific Gmail or Google Workspace address whose sync window you want to change. The setting applies only to that account.
- 3
Find 'Days of mail to sync' under Data usage
Scroll down until you reach the Data usage section. You will see 'Days of mail to sync' with the current value shown below it — typically 30 days on a fresh install. Tap the label to open the input.
- 4
Enter the number of days and tap OK
A dialog box appears with a text field pre-filled with the current value. Delete it, type the number of days you want, and tap OK. Gmail accepts any whole number from 1 to 999. Entering 0 tells the app to sync your entire inbox — all mail ever received — which is not recommended without ample free storage.
- 5
Wait for the sync to complete
The app begins downloading or removing messages to match the new window. For a large increase on a busy account this can take several minutes on a fast Wi-Fi connection. You do not need to restart Gmail. Pull to refresh if you want to trigger it immediately rather than waiting.
Setting it to 0 means every email you have ever received
How the sync setting differs across Gmail platforms#
The same Gmail account behaves differently depending on whether you use the Android app, the iOS app, or a browser. The mismatch is why mail that appears fine on your laptop is missing on your phone — it is not a problem with your account, just a difference in how each platform manages local storage.
| Platform | Offline cache control | Default window | Access to older mail while online |
|---|---|---|---|
| Gmail for Android | User-configurable Days of Mail to Sync (1–999 days, or 0 for all mail) | 30 days | Full — search and open any message in your account from Google's servers |
| Gmail for iOS | Automatic app-managed cache; no user-configurable day count | App-determined, based on recently opened threads | Full — all mail accessible with an active connection |
| Gmail web (any browser) | No local cache setting; browser cache only | N/A — server-side access to the full account | Full — all mail always available |
| Gmail offline (Chrome extension) | Configurable in Gmail Settings > Offline; range 1–90 days | 7 days | Within the window offline; full access online |
Does raising the sync window use more storage?#
Yes — and by more than most people expect. Each message stored locally takes up space: plain-text threads are small, but any thread that includes attachments — a PDF, a presentation, inline images — can add several megabytes per conversation. A jump from 30 to 90 days on an active account that regularly receives attachments can add a few hundred megabytes. A jump to 365 days can push past a gigabyte.
Before changing the setting, go to Android Settings > Storage to check how much free space your device has. If it is already tight, a large sync window will slow down the phone, and Gmail may throttle the sync or quietly roll back the window value to stay within available space. Free up storage first if you want a reliably larger window.
The practical sweet spot for most users is 60 to 90 days. That covers nearly all offline reading needs — a long flight, a weekend without cell service — without a storage hit that noticeably affects device performance.

What to do when the setting does not work#
After changing the sync window, most users see new messages populate within a few minutes on Wi-Fi. If that does not happen, one of the causes below is almost always responsible. Work through them in order.
| Symptom | Likely cause | Fix |
|---|---|---|
| Older mail still missing right after saving the change | Sync is still in progress | Wait 5–10 minutes on Wi-Fi, then pull to refresh the inbox |
| No change after waiting several minutes | Android battery optimization is blocking background sync | Settings > Apps > Gmail > Battery > set to Unrestricted |
| 'Days of mail to sync' is greyed out | Sync is disabled for this account | Gmail Settings > tap the account > turn on Sync Gmail |
| Value saves but reverts to 30 | Device storage is too low to support the larger window | Free up device storage, then re-enter the desired value |
| Threads show 'Not synced yet' | Wi-Fi only sync is set and you are on mobile data | Connect to Wi-Fi, or check whether a Wi-Fi-only sync restriction is active |
| Option does not appear at all | Gmail app is outdated | Update Gmail in the Play Store, then reopen Settings |
Battery optimization is the most common hidden cause
A faster way to find old emails on your phone#
Raising the sync window solves the offline-reading problem. But the more common frustration is finding a specific old email while online — a contract from eight months ago, a thread with a supplier from last year. For that, the sync window is not the limiting factor. As long as you have a connection, tapping Search in Gmail reaches the full account on Google's servers regardless of what is cached locally.
The limitation shows up when you run several inboxes across different providers. Searching for an old contract in Gmail does not surface anything from an Outlook address or a work IMAP account — those live in separate apps, and you have to run the same search again in each one.
We build AI Emaily, an AI-native email client that connects Gmail alongside Outlook, iCloud, Fastmail, and any IMAP account into one place. Its semantic search runs against the full server-side index of every connected account at once, so a search by topic, sender name, or phrase surfaces results across all your inboxes together — regardless of what any individual app has cached to the device. See how it works and start a 7-day free trial at aiemaily.com.
Frequently asked
See it in AI Emaily
Keep reading
Sources

Written by
Nafiul HasanNafiul Hasan is an entrepreneur and AI automation system builder with 10+ years of experience turning messy, manual workflows into reliable automated systems. He designs and ships AI enterprise solutions end-to-end — the agent logic, the data plumbing, and the product people actually use — and founded AI Emaily to give busy professionals their attention back. He writes here from the builder's seat: what works, what breaks, and how to put AI to work without giving up control.