Step-by-step guide

Mail Widget on iPhone: Add It and Choose Which Mailbox It Shows

Put the Mail widget on your Home Screen, switch it to unread, VIP or any mailbox, add Gmail or Outlook accounts, and fix a widget that stops updating.

By Aquarium Widgets · · 5 min read

The Mail widget shows recent messages from one mailbox on your iPhone Home Screen, and you choose which one: unread mail, your VIPs or any other mailbox. Add it from the widget gallery, then tap the mailbox name inside the widget to switch. It shows the accounts you have added to Apple’s Mail app.

Add the Mail widget

  1. Touch and hold the Home Screen background until the apps jiggle.
  2. Tap Edit, then Add Widget.
  3. Search for Mail and tap it.
  4. Swipe through the sizes and stop at the one you want.
  5. Tap Add Widget, move it where you want it and tap Done.

Apple’s Mail widget guide for iOS 27 ↗ points to these general widget steps ↗ and describes the mailbox choices.

Choose which mailbox it shows

Tap the mailbox name shown in the widget, then pick another one. You can also touch and hold the widget, tap Edit Widget and choose from there. Apple uses this exact example in its widget guide. Good choices:

  • Unread: recent messages you haven’t opened yet.
  • VIP: only new mail from the people you marked as VIPs.
  • A custom mailbox: for example a work folder or a mailbox you created for receipts.

If a mailbox you want is missing from the list, open Mail, go to Mailboxes, tap Edit and select it so it appears, as explained in Apple’s guide to organizing mailboxes ↗.

Gmail, Outlook and other accounts

The Mail widget only shows accounts added to the Mail app. To add one, go to Settings → Apps → Mail → Mail Accounts → Add Account, following Apple’s guide to email accounts ↗. If you read your mail in the Gmail or Outlook app instead, search for that app’s name in the widget gallery to see whether it offers its own widget.

When the widget is out of date or missing

  • Check the fetch schedule. Accounts without push only download new mail on a schedule. In Settings → Apps → Mail → Mail Accounts → Fetch New Data, Apple explains that Automatically fetches when the iPhone is charging and on Wi-Fi, so pick a timed schedule if you want updates more often.
  • Make sure the account is on. An account with Mail turned off in Mail Accounts won’t appear in the widget.
  • Look for the Mail app. If the widget is gone from the gallery, check that Mail is still installed by searching for it in App Library, and reinstall it from the App Store if needed.
  • Remove the widget and add it again if it stays blank.

For problems that affect several widgets at once, use our widget not updating checklist. To keep mail out of sight during work or personal time, a Focus Home Screen can show the Mail widget only when you want it.

Frequently asked questions

How do I add a Mail widget to my iPhone?

Touch and hold the Home Screen, tap Edit, then Add Widget, search for Mail, pick a size and tap Add Widget.

How do I change the mailbox in the Mail widget?

Tap the mailbox name in the widget and choose another, or touch and hold the widget, tap Edit Widget and pick a mailbox.

Can the Mail widget show Gmail or Outlook?

Yes, if the account is added to Apple’s Mail app in Settings → Apps → Mail → Mail Accounts. The widget does not read mail from the Gmail or Outlook apps.

Why is my Mail widget not updating?

Accounts without push fetch new mail on a schedule. In Settings → Apps → Mail → Mail Accounts → Fetch New Data, choose a timed schedule instead of Automatically.

Why did my Mail widget disappear?

Check that the Mail app is still installed by searching for it in App Library. If it was deleted, reinstall it from the App Store and add the widget again.