How to Add a Mail Widget to Your iPhone Home Screen

The Mail widget turns a corner of your iPhone Home Screen into a glanceable triage display: unread count, sender names, or subject lines — visible without opening the app. Set it up correctly and it becomes a passive early-warning system for your inbox, useful precisely because it lets you leave Mail notifications off entirely while still catching anything time-sensitive at a glance.

The tricky part is not adding the widget; it is making it useful. Apple defaults the widget to All Inboxes, which for anyone with multiple accounts turns it into a noise counter rather than a signal. This guide covers how to add the widget, how to point it at the right mailbox, which size to choose, how to add a Lock Screen variant, and what to do when it stops refreshing.

The short answer#

Long-press any empty space on your Home Screen until icons begin to jiggle. Tap the + button in the top-left corner, type Mail in the search field, swipe through the size options, and tap Add Widget. The widget drops onto the screen.

To point it at a specific mailbox: with icons still jiggling, tap the widget. An Options panel slides up. Tap Mailbox and select the account or folder you want — VIP, a single Gmail account, your work Outlook inbox. Tap outside the panel or the X to close, then tap Done in the top-right corner.

That is the complete procedure. Everything below covers sizes, Lock Screen placement, iPad differences, and what to do when the widget stalls.

What you need before you start#

The Mail widget is available on any iPhone running iOS 14 or later. Nearly every iPhone in active use today runs iOS 16 or above, so this is not a practical constraint for most people. If Settings > General > Software Update shows a pending update, install it first — widget behaviour in early iOS 14 releases was unreliable, and the per-mailbox option arrived later.

The Mail app must be installed. It is still a free download from the App Store if it is not on your device. Any email account already configured in Settings > Mail > Accounts will appear in the widget's Options panel when you go to select a mailbox.

If you want the widget to show a Gmail or Outlook account specifically, add that account in Mail before placing the widget. You can change the target mailbox later, but having the account visible in Settings > Mail > Accounts beforehand avoids an extra trip through settings mid-setup.

How to add the Mail widget to your iPhone Home Screen#

The steps below apply to any iPhone running iOS 14 or later. Label names are accurate as of iOS 18; Apple occasionally renames items in minor releases, but the underlying actions stay the same.

1. 1

   Enter jiggle mode

   Long-press any empty area of your Home Screen — not on an app icon or the dock. After about a second the icons begin to jiggle, indicating the screen is in edit mode. On iOS 16 and later you can also tap the three-dot menu button that appears at the top of the screen to enter the same mode.

2. 2

   Open the widget gallery

   Tap the + button in the top-left corner. The widget gallery opens — a scrollable list of every app that offers a widget. You can scroll to find Mail or use the search field at the top to get there faster.

3. 3

   Find the Mail widget

   Type Mail in the search field. The Apple Mail widget appears at the top of the results. Tap it to open the size picker.

4. 4

   Choose a size and add the widget

   Swipe left or right through the available sizes. The small widget shows an unread count. The medium widget shows two or three message previews with sender name and subject line. Pick the size that fits your available screen space, then tap Add Widget. The widget drops into the first open slot on your Home Screen.

5. 5

   Point it at the mailbox you want

   With icons still jiggling, tap the widget you just placed. An Options panel slides up from the bottom. Tap Mailbox to see every configured account and folder. Select the one you want — a single account, VIP, a specific folder — then tap outside the panel or the X to dismiss it. Tap Done in the top-right corner to exit edit mode.

Widget sizes, the Lock Screen, and iPad differences#

Apple's widget system offers several placement options across iPhone, iPad, and the Lock Screen. Each surfaces a different amount of information and works best in a specific context. The table below maps the options so you can match the widget to the space you have and the glance you actually need.

What to do when the Mail widget is not updating#

The Mail widget reads from a local cache that Mail updates on its background refresh cycle. If the widget shows a stale count, an old message, or stops refreshing entirely, the cause is almost always one of three things: background app refresh is off for Mail, the fetch interval is set to Manually, or Low Power Mode has suspended background activity. Work through these checks in order — most stale widgets are fixed by the first two.

1. 1

   Check Background App Refresh

   Go to Settings > General > Background App Refresh. Confirm that Background App Refresh is set to Wi-Fi or Wi-Fi & Cellular at the top, and that the Mail toggle is on. If either is off, the widget cannot pull new data between app opens.

2. 2

   Check your Mail fetch interval

   Go to Settings > Mail > Accounts > Fetch New Data. If the schedule at the bottom reads Manually, Mail only checks for new messages when you open the app. Set it to Every 15 Minutes or Every 30 Minutes. Push-enabled accounts like iCloud and Exchange bypass this setting; most IMAP accounts including Gmail and Yahoo obey it.

3. 3

   Check Low Power Mode

   When Low Power Mode is active, iOS suspends background refresh to save battery. The widget will not update until you open Mail manually. Go to Settings > Battery and turn Low Power Mode off if your battery level allows.

4. 4

   Remove and re-add the widget

   If the above changes do not fix it, long-press the widget, tap Remove Widget, and add it again from scratch. This resets the widget's data connection to Mail and resolves cases where a stale render is stuck in the widget cache.

5. 5

   Force-quit Mail and reopen it

   Swipe up from the bottom of the screen (or double-press the Home button on older models) to see open apps. Swipe Mail upward to close it, reopen it, and let the inbox fully load. Return to the Home Screen and wait one or two minutes. The widget should pick up the refreshed data.

A faster way to manage your inbox on iPhone#

The Mail widget is a passive glance — a number or a handful of subject lines on the edge of your vision. It is useful for turning notifications off while still catching something urgent. What it cannot do is help you act: you still need to open Mail, find what matters, and decide what to reply to first.

If your inbox count is a daily source of low-grade stress, the problem is usually volume and triage, not the widget. AI Emaily is an AI-native email client that surfaces the messages that need you first, drafts replies in your voice using a user-set Personal Context brain and per-contact profiles, and holds each send for your approval before it goes out. It is a native iOS app and works across Gmail, Outlook, iCloud, and any IMAP account — no migration required. We build AI Emaily. A 7-day free trial is at aiemaily.com.