[[!img notmuch-logo.png alt="Notmuch logo" class="left"]]
This page describes the tags that the notmuch lib, cli, and emacs ui recognize and treat specially, and whether these tags can be configured.
None of the tags recognized by the lib are configurable.
- draft
- flagged
- passed
- replied
- unread
The above tags are recognized by the lib, and synchronized with the corresponding maildir flags through the following lib function calls:
notmuch_message_maildir_flags_to_tags()notmuch_message_tags_to_maildir_flags()
The cli calls the above functions if the maildir.synchronize_flags configuration option is enabled. Maildir flags are synchronized to tags in "notmuch new", and tags are synchronized to maildir flags in "notmuch tag" and "notmuch restore".
- attachment
- signed
- encrypted
The above tags are assigned to messages that have an attachment, or are signed or encrypted, when adding a message to the database through the lib function call:
notmuch_database_add_message()
The cli calls the above function in "notmuch new".
All of the tags recognized by the cli are configurable.
- unread
- inbox
These are the tags assigned to new message by default. The tags can be changed using the new.tags configuration option.
- deleted
- spam
These are the default tags used for excluding messages from search results. The tags can be changed using the search.exclude_tags configuration option.
All of the tags recognized by the emacs ui are configurable.
- unread
- inbox
The elementary mail reading commands automatically remove the tag(s) specified
by notmuch-show-mark-read-tags ("unread" by default) when visiting a message,
and remove the tag(s) specified by notmuch-archive-tags ("inbox" by default)
when archiving a message.
- replied
- flagged
The tag(s) specified by notmuch-message-replied-tags ("replied" by default)
are added to messages that are replied to, and "flagged" messages are
highlighted through notmuch-search-line-faces by default.