Phabricator/Help/Herald Rules

Creating Herald rules for notifications
This is how you create custom (personal) notification rules in Wikimedia Phabricator's Herald. Imagine you want to watch all the tasks that are being created: This is it. From that point, you will receive an email for every task being created. This is probably too much, though. This is how you can filter these notifications: You see where is this going. Adapting these rules you can watch the entire activity of a specific project without having to join it, you can watch certain keywords across the entire Phabricator, etc.
 * 1) Click.
 * 2) Select   and.
 * 3) Give a descriptive name to the rule, i.e. "All New Tasks".
 * 4) In , select  ,  , and.
 * 5) In , select   and.
 * If you want to be notified about new tasks only in specific projects, add a, and then select   and  , adding the projects you are interested about.
 * If you want to be notified about new tasks only from specific users, add a, and then select   and  , adding the users you are interested about.

Note: It will soon be possible to watch a project without being a member, and without creating herald rules. Please do not create herald rules simply to watch a project. Herald rules take time to execute which means they make phabricator run slower for everyone.

Global Herald rules
To create global Herald rules (rules unrelated to your personal account, like adding a project to a task when another project is added), create a task in Phabricator describing your request. If the request is not completed within a reasonable amount of time, contact one of the Phabricator admins (preferably User:AKlapper (WMF)).

Please note that global Herald rules are expensive and impact Phabricator performance (see T108586). For example, "Add also project X when project Y is associated" rules could often be avoided by using subprojects and milestones.