D2L - Replacement Strings

Last Updated: 08/10/2018


Replacement strings are generally used when one would like to personalize messages without creating several individually targeted items. These strings are used when you would like to personalize messages, instructions, or other information for students. The following will show how to use strings and what strings are accepted by Desire2Learn.

Using Replacement Strings

To use this feature of Desire2Learn, in the message you would like to personalize, simply put the replacement string in the place of the information you are replacing. The following example shows how one would use the first name replacement string to personalize a message with a user's first name.

String entered into the item Content text field:

Hi {FirstName}, Welcome to the course!


Hi Ralphie, Welcome to the course!

Accepted Replacement Strings

Please note that not all replacement strings listed below work in all areas of D2L. Also, replacement strings only work once when used in Content files, so they are best used in other tools. Recommended areas to use replacement strings include homepage widgets, navigation bars, and news posts.

General Replacement Strings

  • {OrgUnitName} – The name of the current course.
  • {UserName} – The viewer’s Identikey username.
  • {OrgDefinedId} – The viewer’s CU Student ID.
  • {FirstName} – The first name of the viewer.
  • {LastName} – The last name of the viewer.
  • {ExternalEmail} – The viewer’s CU email.
  • {RoleName} – The viewer’s role in the course (e.g. Instructor, Student).

Replacement Strings for Intelligent Agents

Intelligent Agents use their own set of replacement strings. To learn more about Intelligent Agents, see the Creating an Intelligent Agent tutorial.