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 phab:settings/panel/emaildelivery/.
- Phabricator mail notifications include message header fields (such as
X-Phabricator-Stampsfor most metadata,
X-Phabricator-Projectsfor project tags associated to the task,
X-Phabricator-Mail-Tagsfor 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-Stampsvalues 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-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
- If you need to specifically filter on subprojects and do not use the Gmail web interface, consider filtering on the
- 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 phab:settings/panel/emaildelivery/.