Customizing Email Subjects for Event Notifications

You can customize the subject line of the emails triggered by Event Notifications:

Changing the subject lines affects all the users in the system, regardless of the recipient’s access level. Users see all the objects and fields included in the email subject.

Some Event Notifications have multiple subject lines, which means that those Event Notifications can have multiple email subjects based on their functionality.

Be careful when deleting default fields for cases when the subject lines refer to multiple objects. Following is the list of event notifications that contain such subject lines:

  • Someone includes me on a directed update
  • Someone includes my team on a directed update
  • Work Item Comment to Thread Participants
  • Work Item Comment to Work Item Assignee

Customizing Email Subject Lines for Event Notifications

  1. Navigate to the Setup area of the Global Navigation Bar.
  2. Expand the Email menu.
  3. Click Notifications.
  4. Select the Event Notifications tab. 
  5. Click the name of an Event Notification, and the subject line editor opens. 
  6. In the type-ahead fields in the Email Subject Line area,  choose and add different fields to the email subject, including custom fields. 
    The names of the fields added must match the camel case syntax of our database structure. For more information about how our objects and their fields are named in the Workfront database, see the "API Explorer."
  7. Click Update to save the new subject lines for your emails.

Customizing Email Subject Lines for Multi-Object Emails

Some Event Notifications have multiple subject lines, depending on from what objects they trigger.
For example, “Someone includes me on a directed update” has two different subjects lines: first is for tasks, issues, template tasks and documents (also known as a “referenceObject”) and the second one is for objects that allow users to make comments, like portfolio, program, etc (also known as a “topReferenceObject”).

If a user is included in a conversation on the task, issue, template task, or document, an email will generate with the first subject line. The subject line contains “referenceObject:name” and the system defines the object and displays the appropriate name in the subject field. The email subject line would look similar to this: "Comment on Task 123 on Project ABC." 

If added to a project conversation an email with the second subject will generate. Here the subject line contains “topReferenceObject:name” and again Workfront identifies which object was referenced and will return that object name instead of “topReferenceObject:name” in the subject. The email subject line would look similar to this: "Comment on Project ABC."

To edit the email subject lines and add additional fields to either subject lines, see "Customizing Email Subject Lines for Event Notifications."

Customizing Email Subject Lines for Multi-Action Emails

Some Event Notifications also have multiple email subjects to outline the different actions which are taken on the objects. For example, the event of requesting a document to be added to an issue can trigger two different emails: one for when the document is added, and one for when the document is edited. 

To edit the email subject lines and add additional fields to either subject lines, see "Customizing Email Subject Lines for Event Notifications."

Audited 6/12/2018

This article last updated on 2018-06-12 16:48:24 UTC