notmore.

Searching mail

Enter one or more terms; by default they are combined with AND. Terms with the same prefix are ORed (for example, tag:inbox unread matches both tags). A lone * matches everything.

Boolean logic

• and, or, not, xor; -term is shorthand for not term (not valid at the start of the query).
• Parentheses control grouping: (tag:inbox or tag:sent) and -tag:spam.
• Proximity: term1 NEAR/5 term2 (within 5 words, any order) or term1 ADJ/5 term2 (within 5 words, same order). Defaults to distance 10.

Common prefixes

• from:, to:, subject:, body: — match headers/body; regex allowed via /.../ for from/subject.
• attachment: (filename/extension), mimetype: (MIME part type).
• tag: or is: — tags such as inbox, unread; regex allowed.
• id:/mid: — message-id without angle brackets; regex allowed.
• thread: — thread id (from search results) or thread:{query} to match threads containing messages matching a nested query.
• path: — maildir path relative to the root; append /** for recursive matches; regex allowed.
• folder: — maildir/MH folder name; regex allowed.
• date: — ranges or single expressions, for example date:2023-01..2023-02 or date:yesterday.
• lastmod: — database revision range, e.g. lastmod:100...
• query: — saved named queries from configuration.
• property: — message property key/value, e.g. property:foo=bar.
• sexp: — S-expression subquery.

Stemming, wildcards, phrases

• Words are stemmed in English (detail/details/detailed match); capitalize to disable stemming (John vs johnson) or use quoted phrases.
• Quoted phrases stay in order and are not stemmed: \"project update\".
• Wildcard: trailing * expands, e.g. migrat*.

Dates and times

• Ranges: date:<since>..<until>. Examples: date:2024-01-01..2024-01-31, date:..last week, date:today...
• Single expression shorthand: date:monday equals date:monday..monday.
• Absolute times: HH:MM, HH:MM:SS, 5pm, noon, midnight; time zones allowed (+02:00).
• Absolute dates: YYYY-MM-DD, DD-MM-YYYY, M/D/YYYY, Aug 3, Wed, etc.
• Relative parts accumulate: 2 weeks, last month, 1h30m. Combine with absolute: 2024-01-01 2d.
• Legacy timestamp ranges: date:@1704067200..@1706745600 (seconds since epoch).

Quoting tips

• Quote spaces or special characters: tag:\"in progress\", folder:\"/^.*/(Junk|Spam)$/\".
• Escape quotes inside queries by doubling: tag:\"\"\"needs-review\"\"\".

Example queries

• tag:inbox and date:last week — inbox mail from last week.
• from:\"/bob@.*example.com/\" and subject:\"status\" — regex sender and subject phrase.
• attachment:pdf and -tag:spam — messages with PDF attachments excluding spam.
• thread:\"{from:mallory}\" and thread:\"{subject:crypto}\" — threads containing both conditions.