<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=691116991096043&amp;ev=PageView&amp;noscript=1">
Skip to content
  • There are no suggestions because the search field is empty.

Workflow Notifications: Add Markdown and Dynamic Content

This article summarises the options for using markdown and dynamic content to format and personalise workflow notifications.

   Estimated Read Time: 4 minutes


Sections in this article: 


Markdown is a simple markup language that helps you customise workflow notifications by adding formatting, links, and images. It can also be used to add dynamic content, allowing you to insert variables (like contract names or dates) that update automatically.

Gatekeeper-Specific Dynamic Values

In addition to standard markdown, Gatekeeper supports specific markdown syntax to help you insert dynamic values into workflow notifications. See the table below for further details:

Markdown Entered Text Example Published Text Example Description
{{ recipient.full_name }} Hi {{ recipient.full_name }} Hi John Doe Populates the full name of the user receiving the notification.
{{ recipient.email }} Dear {{ recipient.email }} Dear john.doe@mailinator.com Populates the recipient's email address.
{{actor.full_name}} {{actor.full_name}} has submitted a form Jane Doe has submitted a form Populates the full name of the user who transitioned the card to the current phase.
{{actor.email}} {{actor.email}} has submitted a form JaneDoe@mailinator.com has submitted a form Populates the above user's email address.
{{workflow.label}} The {{workflow.label}} has a new submission The Contract Approval Workflow has a new submission Populates the name of the workflow this card belongs to.
{{card.name}} {{card.name}} is due to expire in 90 days and requires review Microsoft 365 Subscription is due to expire in 90 days and requires review Populates the card name (usually the contract or vendor).
{{ card.url }} Please use this link to view your card - {{ card.url }} Please use this link to view your card - https://gatekeeperhq.com/workflowcard Provides a link to the form associated with the notification.
{{ exit_phase.label }} A card for you has just been received from {{ exit_phase.label }} A card for you has just been received from Legal Review Populate the name of the phase the card has just left.
{{ enter_phase.label }} A card entering {{ enter_phase.label }} is ready for your review A card entering Manager Approval Phase is ready for your review Populates the name of the phase the card just entered.
{{ enter_phase.sla_due_date }} You have until {{ enter_phase.sla_due_date }} to process this card You have until 04-Mar-2019 to process this card Populates the SLA date of the card on the current phase.
{{ submission }} - - Returns boolean Y/N values for use in conditional statements (see Conditional Markdown Logic for further detail).
{{ approval }} - - -
{{ approval.approved }} - - -
{{ approval.rejected }} - - -
{{ approval.reason }} The card was sent to you with the reason: {{ approval.reason }} The card was sent to you with the reason: Spelling error in title Populates the approval comments submitted by the reviewer.
{% if %} ... {% endif %} - This card was approved. Populates the correct message based on whether the approval outcome was positive (see Conditional Markdown Logic for further detail).

Formatting Options

See the table below for examples of how to format notifications:

Markdown Entered Text Example Published Text Example
![alt text](image-address "title text") ![alt text](https://bit.ly/2GJTZOS "GK logo") GK logo
[link text](linkurl) Please follow [this link](http://gatekeeperhq.com) to your portal Please follow this link to your portal
*italics* Text here *is italicised* Text here is italicised
**bold** Text here **is bold** Text here is bold
**_ italicised and bold_** Text here is ** italicised and bold** Text here is italicised and bold
`quoted` `This is quoted text` This is quoted text
*** OR --- OR ___ Text
***
Text
Text
Text
# Header 1 # This is a big title

This is a big title

## Header 2 ## This is a medium title

This is a medium title

# Header 3
#### Header 4
##### Header 5
###### Header 6
### These are smaller titles
#### These are smaller titles
##### These are smaller titles
###### These are smaller titles

These are smaller titles

These are smaller titles

These are smaller titles
These are smaller titles

Note: Formatting may not appear in emails as it does in Gatekeeper. Depending on mailbox security settings, some recipients may only receive plaintext. Bear this in mind when drafting email templates.

Conditional Logic Markdown

You can use conditional logic to tailor notifications based on how a card reached its current phase - such as approvals, rejections, or other transitions.

For example, if a contract is returned to a user for further review after rejection, the message should differ from one sent when the contract is reviewed for the first time.

These conditional statements can be configured using any of the boolean expressions from the dynamic values table.

If Scenarios

Use if scenarios when you only want to show content if a specific condition is true.

For example, if the notification uses the following markdown in the template:

Dynamic Markdown Content - Google Docs 2019-05-31 14-43-38

When the card is approved, the recipient will see:

Dear John Smith

A contract request has been approved by the Vendor Management team and is ready for legal sign-off

Kind Regards,
Gatekeeper Support Team

 

When the card is rejected, the recipient will see:

Dear John Smith

A contract request has been rejected by the Executive team and requires legal review

For more information, please contact Jane Smith

Their comments were: You seem to have put an extra few zeros on a price

Kind Regards,
Gatekeeper Support Team

If Else Scenarios

Use if else scenarios when you want to show one message if the condition is true, and a different message if it’s false.

For example, if the notification uses the following markdown in the template:

Dynamic Markdown Content - Google Docs 2019-05-31 16-14-05

 

When the card is rejected, the recipient will see:

Dear John Smith

A contract request has been rejected by Jane Smith

Their comments were: This doesn't fit our budget

Please prepare the record for off-boarding

Kind Regards,

Gatekeeper Support Team

When the card was transitioned in any other way, the recipient will see:

Dear John Smith

A workflow form has been sent to you by Jane Smith

Please review & update as needed

Kind Regards,

Gatekeeper Support Team

Additional resources

For the initial setup instructions of Workflow Notifications, see Configure Workflow Notifications.

For information on other markdown formatting options, see this Markdown Cheatsheet.