Skip to Content
Author's profile photo Former Member

How to configure Custom Workflow Email notification in SuccessFactors Employee Central

The Q4 2017 (1711) release of SuccessFactors Employee Central brought much awaited functionality of creating custom workflow email notifications. This is an admin opt-in feature which requires some level of configurations and good understanding of document generation tool.    This blog explains the steps of the configurations to effectively leverage the newly released functionality.


Before elaborating on the functionality, Let us discuss the workflow notification related pain points observed during employee central workflow implementations

  • Few standard templates: There were only few delivered templates which were auto selected by the system based on workflow actions.  For example ‘Workflow Action Pending Notification ‘ which was sent during initiation of any event  , ‘Workflow Action Approval Notification’  which was sent on completion of workflow.  Since same template was selected for all initiations or approvals, not considering the type of event or nature of data change, the information given in notification to the user was limited and generic.  Business always wanted information in the notification specific to the event such as leave of absence versus name or job change.
  • Limitation of tags / variables: There was a finite list of tags or variable which could be used as a part of content in the notification.  The only way different tags could be used was in language specific templates, such as French template could use different content than English template.
  • Lack of flexibility to switch off standard notifications – There was a system restriction that at all times standard workflow notifications were always on and there was no choice to turn them off. This lead to the information overload and unwanted messages in inbox to the managers.  There was not a single project where this limitation was not discussed.


Successfactors now provides an optimized workflow notifications solution and an option to utilize Document Generation tool to prepare and customize workflow email notification content. There is a vast choice of data fields for dynamic content generation i.e., all current and future Employee Data field values which are saved in the system from various portlets.  Businesses have now flexibility to use either standard or custom notification, or even no notification for each workflow step through newly delivered workflow email notification configuration tool.

Custom notification template creation is indeed a huge leap in the area of workflow configurations.  This way the intended audience receives relevant rather than the generic information and can take informed decisions. The added ability to switch the standard notification off saves the unnecessary clogging of mail boxes of approvers and contributors.


For the demonstrations, lets pick up a simplest example of a workflow – Name Change of an Employee where approver receives a custom workflow email notification while CC role receives standard workflow email notification.

For our example, we will configure A Custom workflow notification template and assign this template to the step 1 Approver (to get notified) when a workflow (Name Change) is initiated.

Pre-requisites: Enable Document Generation tool  using provisioning access and maintain the role based permissions to manage document templates and manage document template mapping.

STEP I Prepare custom template and template group using Document Generation tool

To complete a custom template , following actions are required

  1. Create Document generation template group
  2. Create custom Template for Workflow notification in Document Generation tool
  3. Map dynamic text fields to actual employee data fields or workflow tags using Document Generation Mapping tool

Each of these actions are explained in detail below

1. Create Document generation template group
  • Go to Manage Document Template using action search  or from Admin Centre ->            employee files open document generation : Manage document template.
  • Create a document template group (choose category workflow)
  • Give a meaningful name to the group to identify group more easily when assigning this group in workflow email notification configurations.
  • For our example, we will name it WF_ApproverNotifcation_Group as we will assign templates related to approver notification in a workflow step to this group.
  • Ensure the Category is “Workflow”

2. Create custom Template for Workflow notification in Document Generation tool
  • Go to Manage Document Template using action search or from Admin Centre ->                Employee Files -> Document Generation : Manage document template.
  • Give template a meaningful name and description
  • Choose Category “Workflow”
  • You can choose country(optional) if this document should be available for a specific country.
  • Choose Language (You can copy template and and modify in additional languages. Remember to to do variables mapping(Next Step 3.) each time a document copy is created, as mapping is not automatically updated.
  • Assign document group created in previous step( Step 1. Create Document generation template group)
  • Email Header : Define Email subject, you can add dynamic content by using [[ ]] square brackets in email subject.
  • Type Email body text content, any dynamic content (content which will be picked from Subject user’s master data or workflow tags)  should be typed inside square brackets.
  • We will map dynamic content (inside square brackets) to actual fields in the next step 3.Map dynamic text fields to actual employee data fields or workflow tags using Document Generation Mapping tool)

  • Save the template :

3. Map dynamic text fields to actual employee data fields or workflow tags using Document Generation Mapping tool
  • Go to Manage Document Template using action search or from admin centre ->                Employee files open document generation : Manage document template mapping.
  • Select the template created in the step above (2.Create custom Template for Workflow notification in Document Generation tool)and map the fields/content in square brackets from the template
  • Note that there are five types of mappings available, explained below:



  1. Direct – Subject User Master Data (Only approved/saved data is supported)
  2. Rule – Data populated with a rule definition
  3. Past Direct – Historical data value (not pending approval )
  4. Future Direct – Future data value (not pending approval)
  5. Reference – All Existing Workflow Tags are supported

Note : – Add at least one type of mapping as “Reference” otherwise custom notification fails.

Mapping of example template



STEP II Assign the Custom email template group to workflow action

The assignment of newly created email template group (created in step 1)  is done during the creation of workflow notification configuration.

  • Access Manage Workflow Email Configuration from action search or Admin Center->Employee Files -> Manage Workflow Email Configuration

  • Create a new workflow email configuration  and give a meaningful code and name,  in our example lets name it as “WF’_NameChange_Initiated”.  This workflow email configuration will be assigned to the workflow in next step .

  • To the workflow action “workflow initiated” assign the  custom email template group  as shown in the screen shot below.
  • Save workflow email configuration.

Note that rest of the workflow will follow standard templates. You can also turn off some templates if no notification should be mailed out.

STEP III  Assign workflow email configuration to the  workflow

  • Goto Manage Organization, Pay and Job Structures-> Workflow and access the workflow to which the custom email template is to be assigned.  You can also choose to create a new workflow in this step.
  • For our example we have picked the existing Workflow “data change” from my demo system. This workflow triggers when First or Last Name is changed of an employee. In this case we assign Email Configuration Template to Approver Step 1, as we want this template to go out when a workflow is submitted, as shown in the screen shot.

Since For CC role, a standard email template should go out ,  we  have  not made any selection.

Please note that  For CC roles we do not need Step 2. (Assign the Custom email template group to workflow action) to have a custom workflow email template. CC roles can be assigned a Custom Template group directly in the current step. “No Selection” in “Email Template Group” will send standard template to the CC role recipients.



Ok then, we are done with our configuration.  Lets test our custom notification,

Perform an action to trigger the workflow where custom notification is used .  Remember Approver step 1  will receive custom email notification and the CC role will receive standard email notification

Access Employee File -> Personal Information-> Edit/Correct First Name and submit the change.

Some names for you-

Employee : John Parker

Approver Step 1 : Tessa Walker

CC Role : Manager – Joanne Pawlucky


On Submission  following Custom Notification is received by the Approver of step 1, Tessa Walker,  in her email . Review the content of your custom notification.

Note that content highlighted is the  dynamic content in the square brackets inside Email Template and these values are  picked up by the notification automatically.


To approve the workflow, Proxy as Approver Step 1, in the use case Tessa Walker.  Go to Home Page-Approve Requests

Approve the request for Name Change for John Parker


On Approval ,  A notification is  Received by CC roles (Manager Joanne Pawlucky). This will be a standard notification since during configuration we chose to make no selection under email configuration .

Note that approved change has reflected in CC role’s notification, New First name “Brad”  of subject user (John Parker) is reflected as it has been approved.



Custom Workflow Email notifications can now be created by using document generation tool in SuccessFactors. This is an admin opt-in feature and requires configuration and basic knowledge of document generation tool. This enhancement was long awaited and is very well received by business users. Since workflows are an integral part of all business processes, referential information for approvals was very minimal in existing functionality. Workflow email notification can now contain a wide collection of User Data fields. Flexibility to pick and choose notification for each workflow action, or even turning it off at a workflow step has definitely exceeded expectations with this enhancement.

Thanks for taking time to read the blog. Please leave your feedback in the comment section.


About Author

Navjot Sandhu  is an experienced SAP SuccessFactors Consultant and HR domain expert,  certified  in SAP SuccessFactors Employee Central, Compensation Management, Performance and Goals Management.  She has extensive experience in SF implementations across North America and Europe region including multi country Employee Central Implementations with a vast scope on a complex landscape. 

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Marcus Bonrat
      Marcus Bonrat

      Hi Navjot, Thank you for your excellent blog. Can I ask, when configuring Workflow Email Notification (via Manage Workflow Email Notification), we can specify our custom email template group. Here, we specify the custom email template group (as created in Step 1). If we have more than 2 or more document templates tagged to this group, how do we specify which template to be picked by the system ? It seems to me there is no configuration option to specify which document template within the group to choose. Once I choose the group, system assumes there is one and only one document template assign to it ?

      Hope you can enlighten me. Thank you.



      Author's profile photo Former Member
      Former Member
      Blog Post Author

      Hello Marcus,

      The purpose of Template group is  to accommodate same template in different languages.

      You can either copy the same template (with a new name and Language) or create a new template in a different languages and assign this template to the same template group. (Example of copying a template is given below)

      System will then pick up the template from this group based on recipient's language

      Example : Copy Document Template to create a new Template in another language in the same Document Template Group

      I. Copy the current template we used by going to Manage Document Templates ->Open required template->Take Action->Copy Template

      Give a name - For example WF_NameChange_ApproverNotification_FR

      Define a language - For example "French"


      II. Change/translate content of the template in the assigned language.

      Open copied template in Manage Documents Template tool and change/translate the content (to the same language selected in step above)

      III Map the dynamic fields of this template. (Note that copying template does not automatically copy mapping of the fields)

      Open Manage Document Template Mapping tool-> Open the copied template and map the dynamic fields as required.

      III. Result

      Now when you will submit a workflow, and if system found a template in the template group assigned in Workflow Email Configuration in the recipient's language (default locale or language selected by the recipient in the system), it will email that template.

      Hope this answers this question.




      Author's profile photo Marcus Bonrat
      Marcus Bonrat

      Thank you, Navjot for your clear illustration and explanation.



      Author's profile photo Sarika Goda
      Sarika Goda

      Hi Navjot,

      Wonderful explanation on configuring the custom email notification!!

      I do need more inputs though 🙂

      I configured all the steps as mentioned but still can't achieve the expected results.

      My requirement is :

      An email notification to be triggered to employee when there is a change / addition of a Bank Name.

      The text is :

      Hello (preferred name)

      Your bank details have been updated as follows:

      Payroll Bank Account ending in (xxxx) with effect from (effective date)

      Expenses Bank Account ending in (xxxx) with effect from (effective date)

      If you do not see an Expenses Bank Account above, you will not be able to claim expenses via the expenses system

      If you do not see a Payroll Bank Account above, your pay cannot be processed.

      Please call HR Services on (HR Services Number) if you have any concerns regarding changes to your bank details.

      Kind Regards


      Payment Information Details is a custom portlet under Personal Information.

      If you can identify what am I missing and help.


      Appreciate and Thanks!!




      Author's profile photo Former Member
      Former Member
      Blog Post Author

      Hello Sarika,


      Please refer to this KBA

      2424534 - MDF object permission-EC-Document generation

      Payment Information is not supported in document generation as of today.

      I have checked latest release information, and there is no enhancement to cover payment information as yet.




      Author's profile photo Former Member
      Former Member

      Hi Navjot,

      Thank you for putting this together. I followed all the steps you mentioned in Best Run demo instance. However, the custom email is not triggered. I am still getting standard email notification. What could be the problem? Not sure what I am missing out.

      Author's profile photo Former Member
      Former Member

      Hi Jeevan,


      Following are possible reasons for getting standard notification instead of custom notification :


      1. If document generation template group does not have a template in recipient's language, it will send standard notification.
      2. If there is a mapping error in document template mapping step, system will send standard notification and enter error text on top of this notification.
      3. If another workflow triggers for the same data change, and recipient is same but no custom notification is assigned for this workflow, a standard notification will be sent.

      Please review your configuration and workflow assignment again, and you should be able to receive notification with the steps defined in this blog.

      Good Luck!

      Author's profile photo Former Member
      Former Member


      Hi Navjot,


      I want to trigger a custom email onsave for events like hire , rehire . I have created a rule and assigned the workflow value but the email is not triggering. Any thing I am missing if you may guide,




      Author's profile photo Former Member
      Former Member

      Hi Stuti,

      If no notifications are sent (Standard or Custom) then you need to review your business rule configuration.

      Another point to check if no notifications are sent (but business rule triggers successfully), workflow email configuration should be reviewed again. If a step in workflow email notification is set "No Notification" no templates will be emailed (standard or custom).

      If you are able to see a standard notification, then review templates assigned and recipient's language. If system did not find a custom notification in recipient's language, then standard notifications are sent.

      Hope this helps you to investigate your issue further.


      All the best!


      Author's profile photo Amit Albalak
      Amit Albalak

      Can I add fields that are also calculated on the subject of the mail

      Author's profile photo Felipe Johnstone
      Felipe Johnstone

      Hi Navjot,

      Thank you for putting this together. I followed all the steps you mentioned but when i receive the mail notification this has not information from tag fields.



      Author's profile photo Dana Mallon
      Dana Mallon

      We have created copies for the other languages as instructed - however the text of the template was left in English (as was intended to stop them getting the standard notification) - however despite mapping being correct the notification received is the standard one. What else have we missed?


      Author's profile photo Mostafa Keshtari
      Mostafa Keshtari


      When I try to save Document Generation Template this message is appears (Please note that Workflow does not support Read Access Logging for advanced email notifications Do you wish to continue?)

      and when I save and complete the Document Generation configuration , and then start the workflow to send the email using

      Document Generation Template, No email is sent so is this connected to not send the email , this is the screenshot for the message.


      Author's profile photo Ramiro Fernandez
      Ramiro Fernandez

      I have the same Problem, any answer?


      Author's profile photo John Moratis
      John Moratis

      Hello Ramiro,

      Do you have a resolution on this Read Access Logging issue?

      Many thanks,


      Author's profile photo John Moratis
      John Moratis

      Hello Mustafa,

      Can you provide any details on how you were able to resolve this Read Access Logging message?

      Many thanks,


      Author's profile photo Jelencsics Mikolt Cecilia
      Jelencsics Mikolt Cecilia

      Hello Mostafa Keshtari, this warning message has nothing to do with triggerin or not triggering the custom email. This message is obligatory, comes with all templates (if you read it, you will understand why). Look for the problem somewhere else.

      Ramiro Fernandez

      John Moratis

      Author's profile photo Johannes Virtanen
      Johannes Virtanen

      Thank you for the useful guide!

      You should visit my project!

      Author's profile photo Abdul Saleem
      Abdul Saleem

      Very nice blog I wanted to thank you for this excellent read!! I definitely loved every bit of it. I have you saved as a favorite to check out new stuff you post…

      Author's profile photo Mohammed Kurdi
      Mohammed Kurdi

      Thanks for your blogs,

      it is working properly with me but i am facing one issue, when trigger mail the person who is received it showing to him HTML code inside template, how i can hide it



      Author's profile photo Bernardo Santos
      Bernardo Santos

      I don't know if you can help me

      How can I put a custom notification for the employee when approved by the Manager but submitted by the Admin. Any idea? It's in service, but it's giving an error.

      I put the employee as Contribution, and I put the config this way, but it's giving an error.


      Author's profile photo Vinay Sakri
      Vinay Sakri

      Hi Mohammed Kurdi,

      Issue is because HTML email notification is not enabled.

      Kindly follow the below steps:

      1. Go to "Company System and Logo Settings".
      2. Check the Enable HTML e-mail notifications. If it is not not enabled, kindly enable it.
      3. Trigger the custom e-mail notification.

      Hope this information is useful.

      Author's profile photo Annie Tay
      Annie Tay



      Will this work for workflows with multiple approvers? I gave it a try and it doesnt seem to work and hence would like to confirm.


      Thank you.

      Author's profile photo Navreet Kaur
      Navreet Kaur


      Is it possible to create/send different custome notification based on different legal entity?




      Author's profile photo Tania Karmakar
      Tania Karmakar

      Thank you for this blog.


      I have a requirement to send custom email , but the content will be in a PDF Attached. Is that possible ?