Configuring the token map

Current version: 10.4

You can use tokens, or replaceable parameters, in EXM email campaigns to provide values for recipient data whose actual values are not known at the time the email campaign is created.

To control how tokens are replaced with the information, the Email Experience Manager uses a token map class that describes bindings between tokens and properties of a recipient profile. This class must extend the Sitecore.Modules.EmailCampaign.Core.Personalization.RecipientPropertyTokenMap abstract base class.

You can configure the token map in the Sitecore.EmailExperience.Core.config file:


  <recipientPropertyTokenMap type="Sitecore.Modules.EmailCampaign.Core.Personalization.DefaultRecipientPropertyTokenMap, Sitecore.EmailCampaign" singleInstance="true" />

EXM recipients are xDB contacts, or they can come from your custom recipient repository.

The default EXM token map

EXM comes with the following default configuration of the token map and recipient repositories:



Data populated for xDB contact



Concatenation of the first, middle, and last name of the contact



The first name of the contact




The last name of the contact



The preferred email of the contact.



The preferred phone of the contact in the following format: +{country code} {phone number} ({extension})

To retrieve the default token map programmatically, use the following static method:


Do you have some feedback for us?

If you have suggestions for improving this article,