has:newsletter is not a Gmail operator. The undocumented one that works is label:^unsub.

No. The official Gmail search operator reference at support.google.com/mail/answer/7190 does not list has:newsletter. The has: operators it does list cover attachment, drive, document, spreadsheet, presentation, youtube, image, userlabels, nouserlabels, and the various star/marker colors. Typing has:newsletter into the Gmail search box gives you zero results unless you happen to have a Gmail label literally named newsletter, in which case Gmail falls through to label:newsletter behavior.

label:^unsub (with the caret). It is the undocumented system label Gmail auto-applies to messages it classifies as bulk or newsletter mail. The caret prefix indicates a Gmail internal label rather than a user-created one; it cannot be created or deleted from the Gmail UI. The query has been working since at least 2019 and was recently re-surfaced in coverage at labnol.org/gmail-unsubscribe-search-operator-250728. You can combine it with other operators: label:^unsub larger_than:500k older_than:1y finds bulk mail older than a year and bigger than half a megabyte, which is the fastest way to reclaim a gigabyte of Gmail storage.

Caret-prefixed labels are an implementation detail. Gmail uses them to tag messages internally for the inbox, tabs, importance score, and so on. Exposing them as official operators would mean Google has to support them as a public API and never change the names. By keeping them undocumented, the team can rename or remove a label without breaking a published contract. The flip side is that any query you build on top of them can stop working without warning.

category:promotions is narrower. It matches only the messages Gmail routed to the Promotions tab in the tabbed inbox view. label:^unsub matches every message Gmail classified as bulk, including ones that landed in Primary because of how you have your tabs configured or because the sender is a known business contact. If you want every newsletter regardless of tab, use ^unsub. If you want what is in the Promotions tab right now, use category:promotions.

Yes, in both. The system labels are account-level, not view-level. Workspace inboxes carry the same caret labels as consumer Gmail. The query works in the desktop web client, the Android Gmail app, and the iOS Gmail app. Where it does not work is in third-party clients that talk to Gmail via IMAP, since IMAP does not expose Gmail-specific labels.

Two signals carry most of the weight. First, the message includes a List-Unsubscribe header (the standard RFC 8058 way for a sender to announce that the message is part of a list). Second, classifier signals: sender reputation, the volume of identical messages other Gmail accounts received, the presence of an unsubscribe link in the body, and the use of campaign-style HTML templates. A message can pick up ^unsub on the strength of the headers alone, even before the body classifier sees it.

The mobile Newsletters view (and the "Manage subscriptions" surface in the desktop sidebar that started rolling out in 2025) draws from roughly the same set of messages that label:^unsub returns. There is no separate has:newsletter operator behind it; the UI is a saved view that ships built in. If you want the same view in any client, run label:^unsub.

There is no native Gmail operator for "opened but skimmed." You can approximate with label:^unsub is:read newer_than:14d, which gives you the bulk mail you have at least clicked open in the last two weeks. The remaining signal (did the eye actually scan the content) lives in client-side telemetry the public API does not expose. If that distinction matters to you, the right answer is to unsubscribe from anything you do not finish reading; the data does not exist to filter on.

Nothing, on the noise side. label:^unsub is the right primitive for clearing newsletters and Clone does not change it. Where Clone matters is the inverse problem: the threads in your inbox where a real person is waiting on a real move from you. Gmail has no operator for that. A consultant burning 10 hours a week on inbox triage is not losing those hours to newsletters (one keystroke clears those). They are losing them to the proposals, signed SOWs, and dodged replies that need a state-aware response. We wrote a longer guide on that primitive at /t/label-replied-gmail-search-operator.