Mailchimp fields list — Porter Metrics docs
Fields Reference · Mailchimp

Mailchimp Fields List

204 fields · 0 dimensions · 0 metrics · 18 groups

204 of 204
Field nameLabelCategoryDescription
automatic_tweetAutomatic tweet CampaignAutomatically tweet a link to the campaign archive page when the campaign is sent.
campaign_archive_urlCampaign archive URL CampaignThe link to the campaign’s archive version in ISO 8601 format.
campaign_resendableCampaign resendable CampaignDetermines if the campaign qualifies to be resent to non-openers.
can_be_canceledCan be canceled CampaignWhether a campaign send can be canceled.
currency_codeCurrency code CampaignCurrency code.
emails_sentE-mails sent CampaignThe total number of emails sent for this campaign.
facebook_likesFacebook likes CampaignThe number of Facebook likes for the campaign.
preview_textPreview text CampaignThe preview text for the campaign.
recipient_likesRecipient likes CampaignThe number of recipients who liked the campaign on Facebook.
rss_last_sendRSS last send CampaignFor RSS campaigns, the date and time of the last send.
send_timeSend time CampaignThe date and time a campaign was sent.
total_spentTotal spent CampaignThe total spent for a campaign. Calculated as the sum of all order totals with no deductions.
track_clicktaleTrack ClickTale CampaignThe custom slug for ClickTale tracking (max of 50 bytes).
track_ecommerceTrack E-commerce CampaignWhether to enable e-commerce tracking.
track_google_analyticsTrack Google Analytics CampaignThe custom slug for Google Analytics tracking (max of 50 bytes).
track_html_clicksTrack HTML clicks CampaignWhether to track clicks in the HTML version of the campaign. Defaults to true. Cannot be set to false for variate campaigns.
track_opensTrack opens CampaignWhether to track opens. Defaults to true. Cannot be set to false for variate campaigns.
track_text_clicksTrack text clicks CampaignWhether to track clicks in the plain-text version of the campaign. Defaults to true. Cannot be set to false for variate campaigns.
unique_likesUnique likes CampaignThe number of unique likes.
unsubscribedUnsubscribed CampaignThe total number of unsubscribed members for this campaign.
dateDate TimeDate.
day_of_weekDay of week (Mon – Sun) TimeDay of week (Mon – Sun)
hour_of_dayHour of day TimeHour of the day.
monthMonth TimeMonth.
month_dayMonth day TimeMonth and day.
quarterQuarter TimeQuarter.
weekWeek TimeWeek.
yearYear TimeYear.
year_monthMonth and year TimeMonth and year.
year_quarterQuarter and year TimeQuarter and year.
year_weekWeek and year TimeWeek and year.
address1Address 1 ListThe street address for the list contact.
address2Address 2 ListThe street address for the list contact.
cityCity ListThe city for the list contact.
companyCompany ListThe company name for the list.
countryCountry ListA two-character ISO3166 country code. Defaults to US if invalid.
default_from_emailDefault from email ListThe default from email for campaigns sent to this list.
default_from_nameDefault from name ListThe default from name for campaigns sent to this list.
default_languageDefault language ListThe default language for this lists’s forms.
default_subjectDefault subject ListThe default subject line for campaigns sent to this list.
double_optinDouble optin ListWhether or not to require the subscriber to confirm subscription via email.
has_marketing_permissionsHas marketing permissions ListWhether or not the list has marketing permissions (eg. GDPR) enabled.
has_welcomeHas welcome ListWhether or not this list has a welcome automation connected. Welcome Automations: welcomeSeries, singleWelcome, emailFollowup.
list_all_time_open_rateList all-time open rate ListThe average open rate (a percentage represented as a number between 0 and 100) per campaign for the list. This won’t be present if Mailchimp haven’t calculated it yet for this list.
list_average_unsubscriptions_per_monthList average unsubscriptions per month ListThe average number of unsubscriptions per month for the list. This won’t be present if Mailchimp haven’t calculated it yet for this list.
list_campaign_last_sent_dateList campaign last sent date ListThe date and time the last campaign was sent to this list. This is updated when a campaign is sent to 10 or more recipients.
list_cleaned_count_since_sendList cleaned count since send ListThe number of members cleaned from the list since the last campaign was sent.
list_click_rateList click rate ListThe average click rate (a percentage represented as a number between 0 and 100) per campaign for the list. This won’t be present if Mailchimp haven’t calculated it yet for this list.
list_creation_dateList creation date ListThe date and time that this list was created.
list_hard_bouncesList hard bounces ListThe total number of hard bounced email addresses for this list.
list_idList ID ListThe unique list id.
list_last_subscribe_dateList last subscribe date ListThe date and time of the last time someone subscribed to this list.
list_last_unsubscribe_dateList last unsubscribe date ListThe date and time of the last time someone unsubscribed to this list.
list_member_count_since_sendList member count since send ListThe number of active members in the list since the last campaign was sent.
list_merge_field_countList merge field count ListThe number of merge fields (audience field) for this list (doesn’t include EMAIL).
list_modulesList modules ListAny list-specific modules installed for this list.
list_nameList name ListThe name of the list.
list_rating_numberList rating (Number) ListAn auto-generated activity score for the list (0-5).
list_rating_starList rating (Star) ListAn auto-generated activity score for the list (0-5).
list_signup_form_linkList signup form link ListThe full version of this list’s subscribe form (host will vary).
list_soft_bouncesList soft bounces ListThe total number of soft bounced email addresses for this list.
list_unique_opensList unique opens ListThe total number of unique opens for this list.
list_unsubscribes_since_sendList unsubscribes since send ListThe number of members who have unsubscribed since the last campaign was sent.
list_visibilityList visibility ListLegacy – visibility settings are no longer used Possible values: “pub” or “prv”.
multiple_email_formatsMultiple email formats ListWhether the list supports multiple formats for emails. When set to true, subscribers can choose whether they want to receive HTML or plain-text emails. When set to false, subscribers will receive HTML emails, with a plain-text alternative backup.
notify_on_subscribeNotification email for subscribes ListThe email address to send subscribe notifications to.
notify_on_unsubscribeNotification email for unsubscribes ListThe email address to send unsubscribe notifications to.
other_addsOther adds ListThe number of subscribers who may have been added outside of the double opt-in process, such as imports or API activity.
other_removesOther removes ListThe number of subscribers who may have been removed outside of unsubscribing or reporting an email as spam (for example, deleted subscribers).
permission_reminderPermission reminder ListThe permission reminder for the list.
phone_numberPhone number ListThe phone number for the list contact.
recipient_clicksRecipient clicks ListThe number of clicks.
recipient_countRecipient count ListCount of the recipients on the associated list.
stateState ListThe state for the list contact.
subscribe_url_shortSubscribe URL (short) ListURL shortened version of this list’s subscribe form.
subscribessubscribes ListThe number of subscribes.
use_archive_barUse archive bar ListWhether campaigns for this list use the Archive Bar in archives by default.
zip_codeZIP code ListThe postal or zip code for the list contact.
e_commerce_average_orders_revenue_membersE-commerce average orders revenue members List membersCalculated as member total revenue/member total orders
member_average_click_through_rateMember average click-through rate List membersA subscriber’s average clickthrough rate.
member_consents_to_one_to_one_messagingMember consents 1:1 messaging List membersIndicates whether a contact consents to 1:1 messaging.
member_contact_idMember contact ID List membersAs Mailchimp evolves beyond email, you may eventually have contacts without email addresses. While the id is the MD5 hash of their email address, this contact_id is agnostic of contact’s inclusion of an email address.
member_coordinatesMember coordinates List membersMember latitude and longitude coordinates.
member_countryMember country List membersThe member country.
member_country_codeMember country code List membersThe unique code for the location country.
member_currency_codeMember currency code List membersThe three-letter ISO 4217 code for the currency that the store accepts.
member_dst_offsetMember DST offset List membersThe offset for timezones where daylight saving time is observed.
member_emailMember email List membersThe list member’s email client.
member_email_addressMember email address List membersEmail address for a subscriber.
member_email_typeMember email type List membersType of email this member asked to get (‘html’ or ‘text’).
member_gtm_offsetMember GTM offset List membersThe time difference in hours from GMT.
member_idMember ID List membersThe MD5 hash of the lowercase version of the list member’s email address.
member_ip_optMember IP opt List membersThe IP address the subscriber used to confirm their opt-in status.
member_ip_signupMember IP sign up List membersIP address the subscriber signed up from.
member_languageMember language List membersIf set/detected, the subscriber’s language.
member_last_change_dateMember last change date List membersThe date and time the member’s info was last changed.
member_last_noteMember last note List membersThe content of the note.
member_last_note_created_byMember last note created by List membersThe author of the note.
member_last_note_creation_dateMember last note creation date List membersThe date and time the note was created.
member_last_note_idMember last note ID List membersThe note id.
member_nameMember name List membersThe contact’s full name.
member_number_of_ordersMember number of orders List membersThe total number of orders placed by the list member.
member_open_rateMember open rate List membersA subscriber’s average open rate.
member_optin_dateMember opt-in date List membersThe date and time the subscribe confirmed their opt-in status.
member_rating_numberMember rating (Number) List membersStar rating for this member, between 1 and 5.
member_rating_starMember rating (Star) List membersStar rating for this member, between 1 and 5.
member_regionMember region List membersThe region for the location.
member_signup_dateMember signup date List membersThe date and time the subscriber signed up for the list.
member_sourceMember source List membersThe source from which the subscriber was added to this list.
member_statusMember status List membersSubscriber’s current status. Possible values: “subscribed”, “unsubscribed”, “cleaned”, “pending”, “transactional”, or “archived”.
member_tagsMember tags List membersReturns up to 50 tags applied to this member.
member_tags_countMember tags count List membersThe number of tags applied to this member.
member_timezoneMember timezone List membersThe timezone for the location.
member_total_revenueMember total revenue List membersThe total revenue the list member has brought in.
member_unique_email_idMember unique email ID List membersAn identifier for the address across all of Mailchimp.
member_unsubscribe_reasonMember unsubscribe reason List membersA subscriber’s reason for unsubscribing.
member_vipMember VIP List membersVIP status for subscriber.
ab_test_send_dateA/B test send date A/B testingThe possible send times to test. The times provided should be in the format YYYY-MM-DD HH:MM:SS. If send_times are provided to test, the test_size will be set to 100% and winner_criteria will be ignored.
ab_test_sizeA/B test size A/B testingThe percentage of recipients to send the test combinations to, must be a value between 10 and 100.
ab_test_wait_timeA/B test wait time A/B testingThe number of minutes to wait before choosing the winning campaign. The value of wait_time must be greater than 0 and in whole hours, specified in minutes.
ab_test_winner_campaign_IDA/B test winner campaign ID A/B testingID of the campaign that was sent to the remaining recipients based on the winning combination.
ab_winner_criteriaA/B winner criteria A/B testingThe combination that performs the best. This may be determined automatically by click rate, open rate, or total revenue — or you may choose manually based on the reporting data you find the most valuable. For Multivariate Campaigns testing send_time, winner_criteria is ignored. For Multivariate Campaigns with ‘manual’ as the winner_criteria, the winner must be chosen in the Mailchimp web application. Possible values: “opens”, “clicks”, “manual”, or “total_revenue”.
abuse_reports_aAbuse reports A A/B testingAbuse reports for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
abuse_reports_bAbuse reports B A/B testingAbuse reports for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
bounces_aBounces A A/B testingBounces for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
bounces_bBounces B A/B testingBounces for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
clicks_aClicks A A/B testingRecipient clicks for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
clicks_bClicks B A/B testingRecipient clicks for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
forwards_aForwards A A/B testingForwards for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
forwards_bForwards B A/B testingForwards for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
forwards_opens_aForwards opens A A/B testingOpens from forwards for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
forwards_opens_bForwards opens B A/B testingOpens from forwards for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
last_open_date_aLast open date A A/B testingLast open for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
last_open_date_bLast open date B A/B testingLast open for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
opens_aOpens A A/B testingOpens for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
opens_bOpens B A/B testingOpens for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
unique_opens_aUnique opens A A/B testingUnique opens for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
unique_opens_bUnique opens B A/B testingUnique opens for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
unsubs_aUnsubscribes A A/B testingUnsubscribes for Campaign A. Mailchimp does not return information about Multivariate Campaigns.
unsubs_bUnsubscribes B A/B testingUnsubscribes for Campaign B. Mailchimp does not return information about Multivariate Campaigns.
campaign_creation_dateCampaign creation date Campaign detailsThe date and time the campaign was created.
campaign_folder_idCampaign folder ID Campaign detailsIf the campaign is listed in a folder, the id for that folder.
campaign_idCampaign ID Campaign detailsA string that uniquely identifies this campaign.
campaign_last_click_dateCampaign last click date Campaign detailsThe date and time of the last recorded click for the campaign.
campaign_last_open_dateCampaign last open date Campaign detailsThe date and time of the last recorded open.
campaign_nameCampaign name Campaign detailsThe title of the campaign.
campaign_statusCampaign status Campaign detailsThe current status of the campaign. Possible values: “save”, “paused”, “schedule”, “sending”, “sent”, “canceled”, “canceling”, or “archived”.
campaign_typeCampaign type Campaign detailsThe type of campaign (regular, plain-text, ab_split, rss, automation, variate, or auto).
delivery_status_enabledDelivery status enabled Campaign detailsWhether Campaign Delivery Status is enabled for this account and campaign.
delivery_status_nameDelivery status name Campaign detailsThe current state of a campaign delivery. Possible values: “delivering”, “delivered”, “canceling”, or “canceled”.
authenticateAuthenticate Email contentWhether Mailchimp authenticated the campaign. Defaults to true.
campaign_hour_of_the_dayCampaign hour of the day Email contentThe hour of the day a campaign was sent.
content_typeContent type Email contentHow the campaign’s content is put together. Possible values: “template”, “html”, “url”, or “multichannel”.
from_nameFrom name Email contentThe ‘from’ name on the campaign (not an email address).
reply_toReply to Email contentThe reply-to email address for the campaign.
subject_lineSubject line Email contentThe subject line for the campaign.
to_nameTo name Email contentThe campaign’s custom ‘To’ name. Typically the first name audience field.
use_of_auto_footerUse of auto footer Email contentAutomatically append Mailchimp’s default footer to the campaign.
use_of_conversationUse of conversation Email contentUse Mailchimp Conversation feature to manage out-of-office replies.
campaign_bounce_rateCampaign bounce rate BouncesCalculated as Campaign bounces / Emails sent.
campaign_bouncesCampaign bounces BouncesThe total number of bounced email addresses.
campaign_hard_bounce_rateCampaign hard bounce rate BouncesCalculated as Campaign hard bounces / Emails sent.
campaign_hard_bouncesCampaign hard bounces BouncesThe total number of hard bounced email addresses.
campaign_soft_bounce_rateCampaign soft bounce rate BouncesCalculated as Campaign soft bounces / Emails sent.
campaign_soft_bouncesCampaign soft bounces BouncesThe total number of soft bounced email addresses.
campaign_syntax_error_bouncesCampaign syntax error bounces BouncesThe total number of addresses that were syntax-related bounces.
industry_abuse_rateIndustry abuse rate Industry benchmarksThe industry abuse rate.
industry_bounce_rateIndustry bounce rate Industry benchmarksThe industry bounce rate.
industry_click_rateIndustry click rate Industry benchmarksThe industry click rate.
industry_open_rateIndustry open rate Industry benchmarksThe industry open rate.
industry_typeIndustry type Industry benchmarksThe type of business industry associated with your account. For example: retail, education, etc.
industry_unopen_rateIndustry unopen rate Industry benchmarksThe industry unopen rate.
industry_unsubscribe_rateIndustry unsubscribe rate Industry benchmarksThe industry unsub rate.
automation_creation_dateAutomation creation date Automation detailsThe date and time the Automation was created.
automation_idAutomation ID Automation detailsA string that identifies the Automation.
automation_nameAutomation name Automation detailsThe title of the Automation.
automation_start_dateAutomation start date Automation detailsThe date and time the Automation was started.
automation_statusAutomation status Automation detailsThe current status of the Automation. Possible values: “save”, “paused”, or “sending”.
automation_typeAutomation type Automation detailsThe type of Automation workflow. Possible values: “abandonedBrowse”, “abandonedCart”, “api”, “bestCustomers”, “categoryFollowup”, “dateAdded”, “emailFollowup”, “emailSeries”, “groupAdd”, “groupRemove”, “mandrill”, “productFollowup”, “purchaseFollowup”, “recurringEvent”, “specialEvent”, “visitUrl”, or “welcomeSeries”.
campaign_delivery_rateCampaign delivery rate Campaign insightsCalculated as Campaign bounces / Emails sent.
campaign_emails_canceledCampaign emails canceled Campaign insightsThe total number of emails canceled for this campaign.
campaign_open_rateCampaign open rate Campaign insightsThe number of unique opens divided by the total number of successful deliveries.
campaign_opensCampaign opens Campaign insightsThe total number of opens for a campaign.
unique_opensUnique opens Campaign insightsThe total number of unique opens.
list_average_subscriptions_per_monthList average subscriptions per month List all-time totalsThe average number of subscriptions per month for the list. This won’t be present if Mailchimp haven’t calculated it yet for this list.
list_target_growth_rateList target growth rate List all-time totalsThe target number of subscriptions per month for the list to keep it growing (not returned if Mailchimp hasn’t calculated it yet).
list_total_campaignsList total campaigns List all-time totalsThe number of campaigns in any status that use this list.
list_total_contactsList total contacts List all-time totalsThe number of contacts in the list, including subscribed, unsubscribed, pending, cleaned, deleted, transactional, and those that need to be reconfirmed.
list_total_membersList total members List all-time totalsThe number of active members in the list.
campaign_click_rateCampaign click rate ClicksThe number of unique clicks divided by the total number of successful deliveries.
campaign_total_clicksCampaign total clicks ClicksThe total number of clicks for the campaign.
campaign_unique_clicksCampaign unique clicks ClicksThe total number of unique clicks for links across a campaign.
campaign_unique_subscriber_clicksCampaign unique subscriber clicks ClicksThe total number of subscribers who clicked on a campaign.
e_commerce_average_orders_revenue_campaignE-commerce average orders revenue campaign E-commerceCalculated as member total revenue/member total orders
e_commerce_total_ordersE-commerce total orders E-commerceThe total orders for a campaign.
e_commerce_total_revenueE-commerce total revenue E-commerceThe total revenue for a campaign. Calculated as the sum of all order totals minus shipping and tax totals.
list_cleaned_membersList cleaned members List insightsThe number of members cleaned from the list.
list_emails_sentList emails sent List insightsThe total number of emails sent for this list.
list_unsubscribed_membersList unsubscribed members List insightsThe number of members who have unsubscribed from the list.
campaign_abuse_rateCampaign abuse rate Abuse reportsCalculated as Campaign abuse / Emails sent.
campaign_abuse_reportsCampaign abuse reports Abuse reportsThe number of abuse reports generated for this campaign.
campaign_forward_opensCampaign forward opens Campaign forwardsHow many times the forwarded campaign has been opened.
campaign_forwardsCampaign forwards Campaign forwardsHow many times the campaign has been forwarded.
workflow_titleWorkflow title AutomationThe title of the workflow type.