Search
The inbox toolbar has one combined search-and-filter bar. Type to search, or click + Add filter to add a structured filter. Each filter you add becomes an editable chip in the bar.
Free-text search
Type in the bar and press Enter (or ,). Whatever you typed becomes a text chip. Add more text
chips the same way - they all narrow the same query together.
As you type, a dropdown opens beneath the bar with any matching structured filters (e.g. typing
fro surfaces the From filter). Use the arrow keys to move between suggestions and Enter to
pick one - the typed text was just for finding the filter, so it’s discarded and the chip’s
editor opens empty for you to enter the actual value. The plaintext Search for ”…” option
is always at the bottom of the dropdown as a fallback. Press Escape to dismiss the dropdown
without losing what you typed.
The search box looks through subject, sender and recipients, message body, and attachment file names. Phrases in quotes, OR, and minus words to exclude something all work the way they do in many modern search boxes.
Structured filters (chips)
Click + Add filter to pick a filter type. The new chip appears in the bar with its editor already open, so you can fill in the value and move on. Click any chip’s value to edit it, or the × to remove it.
| Chip | What it matches |
|---|---|
| From / To / CC / BCC | The sender or that recipient list, by name or address (substring). |
| Participant | Anyone in From / To / CC / BCC (one chip instead of four). |
| Subject contains | Substring on the subject line. |
| Body contains | Substring on the message body. |
| Tag | A SuperMail tag the thread has. Add the chip multiple times for AND-across-tags. |
| Has attachment | Yes / No. |
| Read | Yes (only read mail) / No (only unread). |
| Starred | Yes / No. |
| Folder | Inbox / Sent / Drafts / Trash / Spam / Archive. |
| Email type | Marketing (has unsubscribe header) vs non-marketing. |
| Sender | Business vs personal, based on the contact classifier. |
| Received after | Only mail received on or after the picked date. |
| Received before | Only mail received on or before the picked date. |
Add Received after and Received before together to bound a date window (e.g. “since I left for vacation but before I came back”).
Filters combine with text chips: a stripe invoice text chip plus a From chip of
billing@stripe.com plus a Received after chip of last month’s date works as you’d expect.
Filtered views are saved in the address bar, so you can bookmark a search or share the link and come back to the same view later.
Migrating old links
Bookmarks that still point at the previous ?q=...&filter=... URL format keep working - the
inbox detects them on load and rewrites the URL into the new chip format automatically.
What we don’t support today
To set expectations:
- There is no Gmail-style operator language in the search box (
from:,to:,tag:,is:,in:,has:,before:,after:,size:). Use the chips above instead. - We don’t OCR PDFs or images. Body text matches the extracted plain-text body of the message, not text embedded in an attachment.
- Saved searches are not implemented yet. If you want a self-updating filter, set up a Rule that auto-tags matching messages and then click that tag in the sidebar.
- Semantic / fuzzy matching is on the roadmap; today the search is exact text matching plus structured filters.
Performance
Searches are built to stay fast as your mailbox grows. If a search feels slow, narrow it with a date range or sender to get back to quick results.