1 # Tags special to notmuch
3 This page describes the tags that the notmuch lib, cli, and emacs ui recognize
4 and treat specially, and whether these tags can be configured.
8 None of the tags recognized by the lib are configurable.
10 ### Synchronization between tags and maildir flags
19 The above tags are recognized by the lib, and synchronized with the
20 corresponding maildir flags through the following lib function calls:
22 - `notmuch_message_maildir_flags_to_tags()`
23 - `notmuch_message_tags_to_maildir_flags()`
25 The cli calls the above functions if the maildir.synchronize_flags configuration
26 option is enabled. Maildir flags are synchronized to tags in "notmuch new", and
27 tags are synchronized to maildir flags in "notmuch tag" and "notmuch restore".
29 (*) The "deleted" tag is not synced to maildir T flag at the moment, but it may
38 The above tags are assigned to messages that have an attachment, or are signed
39 or encrypted, when adding a message to the database through the lib function
42 - `notmuch_database_add_message()`
44 The cli calls the above function in "notmuch new".
46 ## Tags special to cli
48 All of the tags recognized by the cli are configurable.
50 ### Default tags for new messages
56 These are the tags assigned to new message by default. The tags can be changed
57 using the new.tags configuration option.
59 (*) The "new" tag is by no means special or default, but it is documented here
60 as the typically used intermediate tag to use between "notmuch tag" and a
61 post-new tagging script. See [[Initial_Tagging]].
63 ### Default excluded tags
68 These are the default tags used for excluding messages from search results. The
69 tags can be changed using the search.exclude_tags configuration option.
71 ## Tags special to Emacs UI
73 All of the tags recognized by the emacs ui are configurable.
80 The elementary mail reading commands automatically remove the tag(s) specified
81 by `notmuch-show-mark-read-tags` ("unread" by default) when visiting a message,
82 and remove the tag(s) specified by `notmuch-archive-tags` ("inbox" by default)
83 when archiving a message.
91 The tag(s) specified by `notmuch-message-replied-tags` ("replied" by default)
92 are added to messages that are replied to, and "flagged" messages are
93 highlighted through `notmuch-search-line-faces` by default.
95 (*) There are patches to tag, untag, and hide "deleted" tagged messages, but
96 they have not been merged at the time of writing this.