Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Update Email Alerts That Use Corrected Approval Merge Fields

Approval merge fields now provide the correct values in email alerts for approval actions, rejection actions, final approval actions, final rejection actions, and recall actions. If you previously customized your email templates to work around the incorrect values in approval merge fields, update those email templates to accommodate the corrected values. New email templates for approvals are now easier to set up because merge fields in email alerts contain the values that you expect them to.

Where: This change applies to Lightning Experience and Salesforce Classic in Enterprise, Performance, Unlimited, and Developer editions.

How: In each approval process, check for email alerts in the approval actions, rejection actions, final approval actions, final rejection actions, and recall actions.Approval process definition details showing email alerts in affected actions

For each email alert, check whether the email template contains any updated merge fields, such as {!ApprovalRequest.Status} or {!ApprovalRequest.Process_Approver}. Update the email templates as needed to accommodate the corrected values. This table lists the corrected merge fields.

Merge Field Incorrect Value Correct Value
Approval Process Step Name

{!ApprovalRequest.Process_Step_Name}

“ApproveEnd” or “RemovedEnd”. Name of the current step.
Approval Step Approver

{!ApprovalRequest.Process_Approver}

Approver from the previous step. Approver from the current step.
Approval Step Approver ID

{!ApprovalRequest.Process_Approver_Id}

User ID of the approver from the previous step. User ID of the approver from the current step.
Approval Step Assignee

{!ApprovalRequest.Process_Assignee}

Assigned approver from the previous step. Assigned approver from the previous step.
Approval Step Assignee ID

{!ApprovalRequest.Process_Assignee_Id}

User ID of the assigned approver from the previous step. User ID of the assigned approver from the current step.
Approval Step Comments

{!ApprovalRequest.Comments}

When left blank, comments are from the previous step. When left blank, comments are blank.
Approval Step Response Date

{!ApprovalRequest.Response_Date}

Date when the previous step was acted upon. Date when the current step was acted upon.
Approval Step Status

{!ApprovalRequest.Status}

Approval status after the previous step. Approval status after the current step.