AD attributes


One of the most important features of CodeTwo Editor is the possibility to insert Active Directory attributes (such as First name) into email signatures. These variables are added as placeholders and automatically filled with matching information from your AD when the email is stamped with a signature. Why type in every detail manually when you can pull them from AD? Just click on the AD attributes button on the ribbon and select an attribute from the menu (Fig. 1.).

Editor - AD attributes button ER Pro
Fig. 1. The AD attributes menu in CodeTwo Exchange Rules Pro.

Attribute availability

The availability of attributes depends on your environment - different attributes are displayed in the Editor if you use CodeTwo software for on-premises Exchange environments (e.g. CodeTwo Exchange Rules) and different if you work in an Office 365 organization and use CodeTwo Email Signatures for Office 365.

How to add or modify an AD attribute

To insert a placeholder with an AD attribute into an email section (e.g. a signature or disclaimer), you can either use the AD attributes button and choose one from the menu (Fig. 1.), or type it in manually (certain exceptions apply). Note that if you choose to type in an attribute placeholder manually, you must surround it with curly brackets: {attribute name}. Once your placeholder is added, you can modify its properties by right-clicking on it (see Fig. 2.), but this might not always work for manually added placeholders.

Editor - placeholder properties
Fig. 2. Opening the placeholder's properties window.


You cannot manually insert (by typing or copying) placeholders that require additional configuration, as they will not be recognized as proper placeholders and will be treated as standard text. Therefore, you need to add them via the AD attributes button. However, once added, these placeholders are numbered so if you insert them and then delete, you will be able to type them manually as the Editor stores the action of adding particular placeholders into a template according to their insertion order. For example, when you insert the {Message date} attribute placeholder by using the AD attributes menu (see Fig. 1.), it is displayed as {Message date 1} in the Editor. Next, you decide to delete the placeholder. Later, you change your mind and want to add it once again, so you type it manually. As the program recognizes that this particular placeholder has already been used, it is treated as the proper placeholder although inserted manually. On the other hand, any further placeholders of the same type need to be inserted via the AD attributes button, as their numbers will be different from the one previously used, e.g. {Message date 2}.

The list below shows the attributes/placeholders that cannot be inserted manually into a signature/disclaimer template. Note that their availability might depend on your environment. Learn more

  • Custom placeholders
  • {Rotating image}
  • {Rotating text}
  • {Unsubscribe link}
  • {Message Date}
  • {Counter}
  • {Current Date/Time}
  • {QR Code image}

In this article

Was this information useful?