Each time the Add On adds or updates a contact, it sends the member’s email address, name, and membership level details as Mailchimp merge fields. Use these fields to build segments and personalize your campaigns, send extra profile data with custom code, and import members who joined before you set up the integration.

Contact Data Sent to Mailchimp

FieldMailchimp TypeValue
Email addressContact emailThe user’s email address in WordPress.
FNAMEYour audience’s existing fieldThe First Name from the user’s WordPress profile. Sent blank if the user hasn’t entered one.
LNAMEYour audience’s existing fieldThe Last Name from the user’s WordPress profile. Sent blank if the user hasn’t entered one.
PMPLEVELIDNumberOne membership level ID. If the member holds more than one level, this is the first active level Paid Memberships Pro returns for them. Blank for users without a level.
PMPALLIDSTextEvery active membership level ID the member holds, each wrapped in curly braces, such as {2}{5}. Sent as {} for users without a level.
PMPLEVELTextA comma-separated list of the names of every active membership level the member holds. Blank for users without a level.

Before it updates an audience, the Add On checks that the audience has the PMPLEVELID, PMPALLIDS, and PMPLEVEL merge fields and creates any that are missing. You don’t need to add them in Mailchimp yourself. The Add On doesn’t create FNAME or LNAME, so make sure your audience has fields with those tags if you want to store names.

The braces in PMPALLIDS keep each ID distinct, so {5} can’t be mistaken for part of {15} or {50} when you filter contacts by level.

Send Additional Fields to Mailchimp

To send more data, such as a member’s phone number or a User Field they fill out at checkout, use two filters together:

This example sends the value of a user meta field named phone to a Mailchimp merge field with the tag PHONE. Change both to match your site.

function my_pmpromc_send_phone( $fields, $user, $audience ) {
	$fields['PHONE'] = get_user_meta( $user->ID, 'phone', true );
	return $fields;
}
add_filter( 'pmpro_mailchimp_listsubscribe_fields', 'my_pmpromc_send_phone', 10, 3 );

function my_pmpromc_create_phone_field( $merge_fields, $list_id ) {
	$merge_fields[] = array( 'name' => 'PHONE', 'type' => 'text' );
	return $merge_fields;
}
add_filter( 'pmpro_mailchimp_merge_fields', 'my_pmpromc_create_phone_field', 10, 2 );

Fields you add with pmpro_mailchimp_listsubscribe_fields are also added as columns to the CSV export described below. For more examples, see these guides:

Import Existing Members Into Mailchimp

The Add On only syncs members when something happens on your site, such as a checkout, level change, or profile update. Members who joined before you set up the integration aren’t added to Mailchimp until one of those things happens. To add them now, export a CSV of each level’s members and import it into Mailchimp.

  1. Navigate to Settings > PMPro Mailchimp in the WordPress admin.
  2. Under Synchronize a Member’s Level Name and ID, click Click here to export your members list for a MailChimp Import.
  3. Choose a Membership Level and click Download List (.CSV). Repeat for each level you want to import.
  4. In Mailchimp, import each file into the audience you assigned to that level. Map the columns to merge fields with the same uppercase names, such as PMPLEVEL and PMPLEVELID, and choose to update existing contacts so current subscribers get the new data.
Export a CSV for your Mailchimp Import panel with a Membership Level dropdown, Download List button, and Mailchimp import steps

Each file includes active members of the selected level only. The columns are email, FNAME, LNAME, PMPLEVELID, PMPALLIDS, PMPLEVEL, and any fields you’ve added with custom code. To download the file, a user needs the manage_options capability (administrators) or the pmpro_memberslistcsv capability.

Mailchimp’s import screens change from time to time. For a full walkthrough with screenshots, read our guide to importing level name and ID data for existing members.

Last updated on November 13, 2026


Was this article helpful?
YesNo