Send an Email Message From Mixpanel

The Messaging and Mobile A/B testing features are not available for purchase and will be deprecated from the product on January 1st, 2022. Read more information on the Mixpanel blog.

Mixpanel's email builder allows you to drag and drop content, such as images and buttons, into your email. In addition, you can use pre-made templates, and use saved modules to quickly structure your email. This article explains how to build an email message. Learn how to build an email message here.

Mixpanel allows you to tie data to a specific user, creating a profile. This is where you store things like their email address, where they came from, or their age. When you include an email address, you can start sending targeted emails right from Mixpanel. At this time, Mixpanel users on a free account do not have access to email messages. Read more about message limits.

Email targeting can be based on properties in user profiles, or events that did or did not occur within the last 90 days. For example, if you set a Signup date property, you can create an email that only sends to users who signed up over two weeks ago.

Sending Email Addresses to Mixpanel

You can only send emails to users whose profiles have the special $email property. The value of this property should be the email address of the user as a string - something like "". To set this property with the JavaScript library, you can make a call to mixpanel.people.set:

    $email: ""


Using Profile Properties in Emails

Our templates will replace content that is wrapped in {{}}. For example, if you add a Location property to your user profiles, you can send messages like this:

Come and visit us at our {{ user[‘Location’] }} office!

A user with a profile property Location: Asheville will get the following message:

Come and visit us at our Asheville office!

If some of your profiles have a value but others don't, you can use a fallback value:

Come and visit us at our {{ user['Location'] | default:'nearest' }} office!

Profiles without a Location property will receive this message:

Come and visit us at our nearest office!

Using Conditional Logic in Emails

When a fallback value for a missing user profile property is not enough, you can also use conditional blocks to change the contents of your message. Mixpanel treats the tags {% and %} as conditional logic, meaning you can use these tags to create a conditional email message.

There are three tags which will always appear in a conditional block in the same order:

  • The if tag (explained below)
  • The else tag (which is always written {% else %})
  • The endif tag (which is always written {% endif %})

The {% if ... %} tag is the most important as this determines the conditional logic. It consists of:

  • An opening {% and the word if
  • A property name, surrounded by ${ and } (just like in a variable)
  • A closing %}

If the property name after the "if" is defined for a particular profile (meaning it isn't a boolean false value, an empty string, or a zero), then the text between the if block and {% else %} will appear in the email sent to that profile. Otherwise, the part between the {% else %} and the {% endif %} is included. In our Location case, we might use a conditional block like this:

{% if ${Office Location} %}

Come and visit us at our {{ ${Office Location} }} office.

{% else %}

You haven't told us your location. Please update your location in your account, and we'll send you to our nearest office.

{% endif %}

A user with a profile property Location: Asheville will get the following message:

Come and visit us at our Asheville office.

On the other hand, profiles without a Location property will receive this message:

You haven't told us your location. Please update your location in your account, and we'll send you to our nearest office.

Targeting Users

After submitting the form for your message design and content, you will then need to define the targeting criteria for the users who will receive the message. Learn more about filtering by events, properties, and cohorts in this article. You can also target users based on prior messaging or target messages with calendar dates. 


Scheduling Your Emails

Once you've targeted your users, you just have to schedule the email. There are two options for scheduling emails:

  • ASAP messages: These messages go out to individual users as soon as they match the targeting criteria. It's common for users to go from "not matching" to "matching" - many messages include a time-based requirement such as "last login was greater than two weeks ago", or one based off of other profile properties that may change.


  • Scheduled messages: These messages can be set to go out at a specified time, day of week, and interval. For example, you could set your message to go out at 9am PST every Wednesday. When the message runs, it finds all the users who match the criteria you have defined and sends it to them.

Did this answer your question?



Article is closed for comments.