Phabricator/Help/Managing mail

Jump to navigation Jump to search

Changes in Phabricator tasks can create a lot of notification emails. This page covers on a per-user level how you can prioritize mail that you receive. Your edits are welcome to document good practices on this page.

Reducing the number of notifications[edit]

If you plan to mass-edit a lot of tasks in the same way and want to reduce the notifications which your action will create, see Phabricator/Help#Batch edits instead.

Filtering notifications[edit]

  • Phabricator mail notifications include message header fields (such as X-Phabricator-Stamps for most metadata, X-Phabricator-Projects for project tags associated to the task, X-Phabricator-Mail-Tags for actions performed) that common email clients (except for the GMail web interface) allow filtering on.
    • If you use the GMail web interface and want to inspect the header fields of an email, click Show original in the message dropdown menu.
  • If you use the GMail web interface and want to filter on header fields, set Send Stamps to Mail Headers and Body under phab:settings/panel/emailformat/. This will duplicate the content of the header fields to the bottom of the message body. Gmail allows filtering on content in the message body. Steps and screenshots are available in phab:T150766#3977670.
  • Depending on your needs, you could filter on X-Phabricator-Stamps values such as actor(@username) (who triggered the notification), author(@username) (author of the task), tag(#someproject) (but not for subprojects as only an internal PHID is used), task-owner(@username) (task assignee), task-priority(number) (available numbers: 100 = unbreak now; 90 = needs triage; 80 = high; 50 = medium; 25 = low; 10 = lowest), task-status(status) (status such as "open"), task-unassigned() (when no task assignee is set).
  • You can also distinguish when you were explicitly mentioned in a comment by filtering X-Phabricator-Stamps on mention(@yourusername).
  • If you need to specifically filter on subprojects and do not use the Gmail web interface, consider filtering on the X-Phabricator-Projects instead of X-Phabricator-Mail-Stamps.
  • Please read the Managing Phabricator Email user guide for more information.

Alternative: Web notifications[edit]

If you strictly only follow tasks and projects that you regularly want to see all updates about (for example by using personal flags for "less important" tasks that don't require regular awareness), you could change numerous dropdowns in your email preferences under "Maniphest Tasks" from "Email" to "Notify" and then check your latest unread web notifications.

Disabling email notifications[edit]

See Also[edit]