Using Tokens in your Alert Plus Email Message

Using Tokens in your Alert Plus Email Message

One of the great features of the Alert Plus Web Part is that it allows you to specifically format the email message for each alert you create. This way the Email recipients know exactly why they are getting the message.

You are not limited to static text in the subject or message body. The use of special tokens allows you to include references to dynamic objects such as Alert List columns, the alert item, or the site where the Alert List resides. As part of that formatting, you can use special tokens in the subject or the body of the HTML-based template. These special tokens are replaced with Alert List column values and other constructs when the message is created and sent.

Available Tokens in Alert Plus are described in the table below.

Token Description Use in a Hyperlink tag?
{[Column Display Name]}

Add the value of any Alert List column name to the Email message. For example, the token {Due Date} will insert the value of the item’s Due Date column into the subject or message (wherever you have placed the token).

Icon-WarningIMPORTANT: These tokens are case-sensitive! If the column name is Title and you use the token {title}, no values will appear in the email message.

Icon-WarningIMPORTANT: In Alert Plus v4.x and higher, if you are alerting on a view of a list, each token must be included in the view. If its not in the view, it’s value wil not appear in the Email message.

Yes
{[Column Display Name]/Old}

Add the previous value of any Alert List column name to have the old item value for that column inserted. For example: The token {Title/Old} will insert the value of the Title column BEFORE the change.

Icon-WarningIMPORTANT: These tokens are available only if the alert Trigger Type is A specific column in the list changes.

No
{[Comment Column Display Name]/New}

This applies only to multiline text fields that allow appended data. The /New switch will show only the most recently appended content.

Icon-WarningIMPORTANT: These tokens are available only if the alert Trigger Type is A specific column in the list changes.

NOTE: This feature is only available in Alert Plus version 4.0 and later.

No
{ItemURL} Inserts a link to the item that generated the alert. Yes
{SiteURL} Inserts a link to the site where the item that generated the alert resides. Yes
{itemlink}

Inserts a link to the item that generated the alert.

Icon-Tip The link construction method is dictated by the contents of the External Host Path and Custom Item Link fields on the Mail Format – Options tab.

No
{sitelink}

Inserts a link to the site containing the Alert List.

Icon-Tip The link construction method is dictated by the contents of the External Host Path and Custom Item Link fields on the Mail Format – Options tab.

No
{FolderName} Inserts the name of the folder where the alert item resides. Yes
{FolderPathName}

Inserts the names of nested folders where the alert item resides. In other words, if the item resides in a folder that is in another folder, the {FolderPathName} includes the names of all the folders in the path to reach the alert item.

Icon-Tip Use this token when building a Custom Item Link on the Mail Format – Options tab.

Yes
Images

Images can also be inserted into the e-mail Message Templates through the use of the HTML IMG element. Type in the image element and the source path to the image file to insert.

NOTE: The image file to be shown must exist at a location that can be resolved with a relative or fully-qualified URL path. On subsequent edits of the message template you will not see the IMG element, but rather the picture itself. If you desire to change the linked image, then you will first need to delete the existing picture.

No