How Many Labels Can You Have in Gmail?

The short answer
Yes — Google documents a hard cap of 5,000 labels per Gmail account, plus a separate 1,000-filter cap on the automation that applies them. Both apply account-wide, across web, mobile, and any connected client. In practice, a sidebar stops being usable at a few hundred flat labels, long before either official limit is reached.
Gmail caps accounts at 5,000 labels and 1,000 filters, but Google's own guidance says slowdowns start well before 500. Here's the real ceiling.
On this page
- 01The short answer
- 02Before you start: what actually counts toward the cap
- 03How to check your current count before you hit either cap
- 04Platform differences: web, Workspace, IMAP clients, and the API
- 05What to do when Gmail won't let you create another label or filter
- 06A faster way to keep this from becoming a recurring decision
How many labels can you have in Gmail? Google's own help documentation puts a hard number on it: up to 5,000 labels per account. That ceiling almost never comes up in daily use, because almost nobody gets there — the real limit arrives much sooner, at the point where a sidebar full of nested categories stops being a filing system and starts being scenery you scroll past without reading.
This post covers both numbers: the account-wide cap Google enforces, and the much lower point at which Google's own admin documentation says labels start slowing Gmail down. It also covers the separate cap on filters — the automation most people use to apply labels without touching them by hand — and what changes if you're on a Google Workspace seat, connecting over IMAP, or creating labels through the Gmail API rather than by hand in Settings.
The short answer#
Yes, there's a limit, and it's a firm one: Gmail's help documentation states plainly that you can create up to 5,000 labels per account. That's enforced server-side — reach it, and label creation stops working until you delete something.
A second, separate cap governs the automation most people use to apply labels without touching every message by hand. Gmail limits every account to 1,000 filters, documented in the Gmail API reference. Filters and labels are counted independently, so maxing out one has no effect on your headroom in the other.
Neither number is what usually stops people first. Google's own Workspace troubleshooting guide — aimed at admins fixing a slow Gmail for their users — recommends staying under 500 labels, sublabels included, and under 500 filters, for performance reasons that have nothing to do with the hard cap. That's the number worth planning around.
- 5,000 labels — the hard, account-wide cap Google documents for label creation.
- 1,000 filters — a separate hard cap on the automation that applies most labels for you.
- 500 labels (sublabels included) and 500 filters — the point Google's own Workspace performance guidance says to stay under, well short of either hard cap.
Before you start: what actually counts toward the cap#
A nested label is not one entry with children riding along for free — it's a full label in its own right, counted separately against the 5,000. Create "Clients," then nest "Acme" and "Globex" underneath it, and you've used three of your allowance, not one. A tree that looks tidy in the sidebar can still be wide and deep underneath it, and every leaf on that tree counts.
The system labels Gmail creates automatically — Inbox, Sent, Drafts, Starred, Important, Spam, Trash, and All Mail — sit outside this discussion in practice. Google's help page states the 5,000 figure as the number of labels you can create, which reads as the custom ones you add; it doesn't separately confirm whether the built-ins count inside or outside that number, so treat 5,000 as the safe ceiling on labels you add yourself rather than a line you can push right up against.
Labels created through the Gmail API or a connected third-party app count exactly the same as ones you create by hand. A tool that files a new label per sender, per project, or per thread — rather than reusing a fixed set — can run through hundreds of labels in a single busy month without anyone deciding to create them one at a time.
Nesting is a naming convention, not a separate structure
How to check your current count before you hit either cap#
- 1
Open Settings, then the Labels tab
Click the gear icon, choose "See all settings," and open the Labels tab. This is the only screen in the Gmail interface that lists every label you've created, nested ones included, in one place — though it doesn't show you a running total.
- 2
Get an exact count from the Gmail API if you need one
Open the API reference for users.labels.list, use the interactive "Try it!" panel, authorize with the account you want to check, and run the request. The response returns every label as a JSON array; the length of that array is your exact count, system labels included.
- 3
Delete or hide what you don't use
In Settings → Labels, each row has a remove link and a show/hide toggle. Deleting removes the label from every message that wore it; hiding just takes it out of the sidebar while leaving it searchable. A label nothing has touched in the last year is a candidate for one or the other.
- 4
Do the same pass on your filters
Settings → Filters and Blocked Addresses lists every filter you've created. Filters accumulate the same way labels do — one built for a short-term project or a former client rarely gets deleted once its job is done. Removing the ones you no longer need frees room under both the hard cap and the 500-filter performance line.
- 5
Consolidate near-duplicates before creating something new
Before adding a label, check whether an existing one already covers the same ground under a slightly different name. "Invoices" and "Billing" meaning the same thing to you is twice the sidebar clutter for no organizational benefit — merge one into the other by re-labeling its messages, then delete the redundant one.
Platform differences: web, Workspace, IMAP clients, and the API#
The 5,000-label and 1,000-filter caps are account-wide, enforced by Google's mail servers rather than by whichever app you happen to be viewing your inbox through. What changes by platform is how much of that structure you can see and manage, not how much of it you're allowed to have.

| Platform | What you can see or manage | Cap that applies | Practical note |
|---|---|---|---|
| Gmail web | Full label list, nested and collapsible, in the left sidebar | 5,000 labels / 1,000 filters, account-wide | The only place with a dedicated Labels settings tab for bulk cleanup |
| Gmail mobile app (iOS / Android) | Same label list, reached through the menu | Same account-wide caps — they aren't set per device | Long lists scroll further on a small screen; search finds a label faster than scrolling to it |
| Google Workspace | Identical label UI to a personal account | Same 5,000 / 1,000 caps; no separate higher tier for paid seats | Google's own admin troubleshooting guide recommends staying under 500 of each for performance |
| IMAP-connected client (Outlook, Apple Mail, Thunderbird) | Labels with "Show in IMAP" enabled appear as folders | Same account-wide caps, enforced by Gmail regardless of client | A nested label shows as a folder path — Clients/Acme appears as a Clients folder containing an Acme folder |
| Gmail API / connected third-party apps | Labels are IDs; nesting is a naming convention using "/" | Every API-created label counts the same as one made by hand | An app that auto-creates a label per sender or thread can burn through the cap without anyone approving each one |
What to do when Gmail won't let you create another label or filter#
If you try to create a label or a filter and nothing happens — or Gmail shows a generic error instead of saving what you typed — the most common cause by far is a forgotten automation, not a genuinely full account. A single Zapier or Make scenario that creates a label per new lead, or a shared-inbox tool that tags one per assigned teammate, can quietly generate hundreds of one-off labels a person would never create by hand.
Check Settings → Labels first, sorted alphabetically, and look for a pattern rather than reading every row: a long run of labels sharing a prefix, or names that look generated rather than typed, points straight at the automation responsible. Disable or reconfigure that integration before deleting labels one at a time, or it will simply refill the space you just freed.
If the count genuinely is close to 5,000 and every label is one you recognize, the fix is the same triage as any full storage system: delete what nothing has touched recently, keep what's actively used, and stop nesting deeper than you can navigate at a glance. There's no request process for a higher ceiling on an individual account — Google doesn't offer one.
Deleting a label removes the label, not the mail
A faster way to keep this from becoming a recurring decision#
Everything above is manageable by hand, and plenty of Gmail accounts run fine that way for years. What gets harder is doing it continuously — catching a runaway automation the week it starts rather than the month you finally notice, and re-deciding, every time a new kind of mail shows up, whether it deserves a new label or fits an existing one.
We build AI Emaily, an AI-native email client. Its own label and rules system runs on top of Gmail, Outlook, and IMAP without writing anything back to your provider's native labels, so it never adds to Gmail's 5,000-label count, and it works the same way on accounts that have no concept of labels at all. Rules apply tags automatically as mail arrives instead of accumulating one filter at a time — see how it's set up on the labels documentation page. There's a 7-day free trial on Pro or Autopilot.
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.