How to create Mailchimp merge tags

How it works

A merge tag is a unique, text-based identifier that corresponds to account data, such as an audience field. Merge tags are used to insert personalized or dynamic content into your emails. For example, you can use the * |FNAME| * tag to insert the user’s name into the email: Hello, * |FNAME| *. Refer to Mailchimp documentation for more information about merge tags.

You can create merge tags for the properties of user’s accounts in Xsolla’s system (i.e. user name, birth date, nickname, gender, etc.) and use this data for your email newsfeed.

Notice
Xsolla can’t retrieve already existing fields from Mailchimp. To ensure merge tags work correctly, they must be created in Publisher Account.

Who can use it

Partners who export their users to Mailchimp.

How to get it

To create a Mailchimp merge tag:

  1. In your project in Publisher Account, go to the Login section.
  2. Select the login option and go to the Users section.
  3. Click Mailchimp and select Edit merge tags in the menu.
  4. Click Add tag and fill in the following fields:
    • Field to export — select one of the following properties of a user’s account from a dropdown list:
      • Nickname
      • Birth date
      • First name
      • Last name
      • Gender
      • Server custom ID
    • Field label — a label for the field that will be displayed in Mailchimp. Maximum length: 50 characters.
    • Merge tag. Should not contain spaces. Maximum length: 10 characters.
  5. Click Confirm.

Note
Users are exported to the contact list only if they confirmed their email address and agreed to receive newsletters.
Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Last updated: July 7, 2025

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!
We couldn't send your feedback
Try again later or contact us at doc_feedback@xsolla.com.