Gmail Widgets on Android: Which One Belongs on Your Screen

The short answer
Gmail offers two Android widgets — a Gmail widget for your inbox or another category, and a Gmail label widget locked to one label — plus a Compose shortcut from the app icon's long-press menu. Add either widget by holding the home screen, tapping Widgets, then Gmail. Pick the label widget if a full inbox pulls you in too often.
Gmail widget vs Gmail label widget vs compose shortcut on Android — what each shows, how to add one, and fixes for stuck or missing widgets.
On this page
- 01The short answer
- 02Before you start
- 03How to add a Gmail widget to your home screen
- 04Widget, label widget, or shortcut — which fits how you check email
- 05How this differs by launcher, OEM skin, and Gmail version
- 06The widget went missing, or stopped updating — what to check
- 07A faster way than checking a widget
A Gmail widget on your Android home screen is one of two things: a scrolling list of recent messages, or a shortcut to a single label. There's no third "official" widget, but there is a third useful option that isn't technically a widget at all.
This post compares all three by what they actually do to your checking habits, walks through adding one, and covers the two complaints that show up in every Gmail help thread: the widget stops updating, or it vanishes after an update.
None of this is exotic — it's all built into the Gmail app you already have installed. The only real decision is which of the three belongs on limited home-screen space, and that depends more on how you check email than on which widget looks better.
The short answer#
Gmail ships two widgets. The Gmail widget shows recent messages from your inbox or a category you pick. The Gmail label widget does the same thing but locked to one specific label, like Starred or a client folder. Both update on Gmail's normal sync schedule and both are resizable.
The third option isn't in the widget picker: long-press the Gmail app icon and its shortcut menu includes Compose, plus one shortcut per signed-in account. Drag that onto the home screen and you get a pure action button — no message content, nothing to glance at.
| Option | Shows | Best for |
|---|---|---|
| Gmail widget | Scrolling list of recent messages, sender and subject, from your inbox or a chosen category | Seeing what's new without opening the app |
| Gmail label widget | The same scrolling list, locked to one label or folder | Watching a single queue — Starred, a client tag, a "Follow up" label |
| Compose shortcut | Nothing. A static icon with no message content | Sending a quick email with no temptation to read anything first |
Before you start#
- Gmail is installed and has been opened at least once — the widget picker only lists widgets for apps that have actually launched.
- Your launcher supports widgets. Almost all do, but a few minimal or icon-pack launchers hide the widget picker.
- You know which account and which category you want before placing it. The widget asks once; changing your mind later means removing and re-adding it.
- If you run more than one Gmail account, decide up front how many widgets you need — a single widget only ever tracks one account, so covering three accounts means placing three widgets.
- You're on a reasonably current Gmail app version. Google pushes widget changes through regular app updates rather than a separate download, so the update queue in Play Store matters more here than for most features.
How to add a Gmail widget to your home screen#
- 1
Open the widget picker
Touch and hold an empty spot on your home screen until the menu appears, then tap Widgets.
- 2
Find Gmail in the list
Scroll to Gmail — widgets are grouped by app. If it isn't listed, open the Gmail app once first, then check again.
- 3
Choose Gmail or Gmail label
Gmail covers your inbox or another category; Gmail label locks onto one specific label or folder.
- 4
Drag it onto the home screen
Long-press the widget preview and drag it into an empty space, then lift your finger to drop it.
- 5
Pick the account and category
On first placement, Gmail asks which account and which category the widget should track. Repeat the process for a second account.
- 6
Resize if you want more or fewer rows
Long-press the placed widget and drag the dots on its edges. A label widget with three items doesn't need six rows of empty space.
Widget, label widget, or shortcut — which fits how you check email#
Every widget on a home screen is a standing invitation to look. The Gmail widget shows previews the moment new mail arrives, which is exactly why it's the one most likely to turn a glance into five minutes of scrolling.
The label widget narrows that pull without removing it — you still see message content, just from one queue instead of the whole inbox. That's the version worth keeping if you check email more than you'd like: point it at a single actionable label, not at Inbox.
The compose shortcut carries no content at all, so there's nothing to read and nothing pulling you back in. If your actual complaint is that you check email too often, that's the one to put on the screen — and the reason to leave the content widgets off it entirely.
You don't fully lose one-tap composing by choosing a content widget instead of the shortcut, either. Since the Material 3 Expressive update reached the widget in January 2026, both the Gmail and Gmail label widgets carry their own compose button — a pill-shaped tap target in the widget's top corner — alongside the message list.

How this differs by launcher, OEM skin, and Gmail version#
The two widgets above are Google's, but what you see when you go looking for them varies. Available widgets vary by launcher, OEM skin, and which Gmail version is installed — so a screenshot from one phone won't always match what's on yours.
The current widget layout dates to a January 2026 Gmail update: the compose button became a pill instead of a rounded square, padding along both edges shrank so more of the subject line shows, and a small folder icon now sits in front of the category name in the header. None of that changes what the widget does — it's the same two widgets, redrawn.
| Launcher or setting | What's different |
|---|---|
| Stock Android / Pixel launcher | Widgets resize freely in both directions; Gmail appears in the standard alphabetical Widgets list. |
| Samsung One UI | The widget picker works the same way, but a separate setting — App icon badges, under Notifications — controls whether the Gmail icon shows a numeric count. The widget itself still doesn't. |
| Other launchers (Nova and similar) | Some replace the stock widget picker with their own UI, and a few can force a numeric badge onto the Gmail icon that stock Android won't show. |
| Gmail app version | Widget options are tied to the installed version. An outdated Gmail can be missing the label widget, or still show the pre-2026 widget layout instead of the current one. |
The widget went missing, or stopped updating — what to check#
Two complaints account for most of the Gmail widget threads in Google's own support forum: the widget freezes on old messages, or it disappears entirely after the app updates. Both have the same two or three causes.
- Frozen on old messages: force-stop Gmail (Settings → Apps → Gmail → Force stop), reopen it once to let it sync, then check the widget again.
- Disappeared after a Gmail update: remove the stale widget and re-add it from the picker — an update can change the widget's internal ID, which orphans the copy already on your screen even though the widget still exists.
- Widget shows an account you removed: remove the widget, then add it back and choose the correct account. A removed account doesn't update in place.
- Nothing shows up under Widgets → Gmail at all: open the Gmail app fully once, then check the picker again — the system only lists widgets for apps it has actually launched.
- Widget list is empty even though the account clearly has unread mail: check which category the widget is pointed at. A label widget scoped to "Starred" will look broken if nothing is starred — it isn't missing mail, it's correctly showing zero for what it's watching.
Battery optimization looks like a broken widget
A faster way than checking a widget#
Every option above still means glancing at a widget, deciding what needs a reply, and doing the reply yourself. On Android, AI Emaily runs as a home-screen install rather than a native app — you add it once and it behaves like an installed app: an icon, offline reading and drafting, and push notifications, with a native Android app on the roadmap.
What it changes versus a widget: new mail gets triaged against your rules into a unified view instead of piling every account into one preview list, and replies are drafted for your approval rather than left for you to write from scratch. Content reaches you as a shortlist of what needs you, not a running feed to react to all day.
We build AI Emaily.
Frequently asked
See it in AI Emaily
Keep reading

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.