Phabricator/Help/Managing mail

Changes in Phabricator tasks can create a lot of notification emails. This page covers ways to prioritize mail and welcomes documenting helpful practices.

Reducing the number of notifications

 * Check your email preferences for which specific actions (e.g. status, owner, priority, subtask, or subscriber changes) in a task you would like to (not) receive notifications. Prolific users might want to reduce email settings to a minimum, such as in File:Phabricator email settings panel.png.
 * As a project member, you can opt out of project mail via the Disable Mail on the project's Members page.
 * If you get notifications for all tasks in a project and want to not get notified about a specific task, use Mute Notifications in the specific task.
 * You can disable notifications about your own actions under settings/panel/emaildelivery/.

Filtering notifications

 * Phabricator mail notifications include message header fields (such as  for most metadata,   for project tags associated to the task,   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 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 T150766.
 * Depending on your needs, you could filter on  values such as   (who triggered the notification),   (author of the task),   (but not for subprojects as only an internal PHID is used),   (task assignee),   (available numbers: 100 = unbreak now; 90 = needs triage; 80 = high; 50 = normal; 25 = low; 10 = lowest),   (status such as "open"),   (when no task assignee is set).
 * You can also distinguish when you were explicitly mentioned in a comment by filtering  on.
 * If you need to specifically filter on subprojects and do not use the Gmail web interface, consider filtering on the  instead of.
 * Please read the Managing Phabricator Email user guide for more information.

Alternative: Web notifications
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

 * You can completely disable email notifications under settings/panel/emaildelivery/.