1. Home
  2. Direct Integration
  3. Custom Mailing List Fields

Custom Mailing List Fields

Integration with your mailing list means that your BookFunnel signup page can add new subscribers to your mailing list instantly. The landing page settings you select determine which list we add emails to, and whether the reader’s first and/or last name is collected and included.

If you’re a data lover like us, you might want a bit more information, and we make that easy! You can save consent field data and extra custom field data when adding subscriber data to your list.

Consent field data is sent automatically with every subscriber from BookFunnel, and includes data like the reader’s country of origin and whether the country is in the EU/EEA.

If your email list has a field that matches the data we include, the data will be added to the subscriber’s profile. If your list does not have a corresponding field for the data, this additional data is “thrown out” by your mailing list provider.

This is the consent data we automatically send when adding a new subscriber:

  • IP address – the reader’s IP address at the moment they subscribed
  • Country – their location at the time they subscribed
  • Country Code – a two-letter country abbreviation
  • Is EU country? – a yes or no

The IP address is saved automatically by your mailing list provider.

To store any of the location data, you will need to add one or more of these custom fields to your mailing list and name them exactly:

  • country
  • country_code OR country_cd*
  • is_eu_country OR eu_country*

*MailChimp has a character limit, so we use both a short, MailChimp-friendly custom field label and a longer, more descriptive field label that you can use for every other mailing list provider.

Extra Custom Field Data

You can optionally send additional data as custom fields, like the title of the book they received or which marketing effort brought them in (Example: Facebook Video Ad). Each email signup page on BookFunnel can pass different data to your list, depending on the settings you choose.

How To Send Custom Field Data

To send subscriber data in a custom field, you must first have created the field on your mailing list service. BookFunnel cannot create a new field for you. If the field already exists, we will send the data along with the subscriber’s email address and the custom field will be populated with the value you set.

How to Add a Custom Field on Each Platform

Want to include custom field data, but aren’t sure how to add the field on your email service provider’s website? We’ve rounded up the how-to for each integrated platform:

ActiveCampaignAuthor.Email *Aweber
ConvertKitConstant Contact **EmailOctopus
GetResponseMailChimpMad Mimi
MailerLiteSendySendFox *
* Does not support custom fields/ no how-to documentation
** Some restrictions, see Constant Contact section

How to add custom field data to your signup page:

  1. Create a new email signup page on BookFunnel or edit an existing email signup page.
  2. Make sure the opt-in settings either requires or invites a reader to join your list.
  3. Under Integration List, select the list you want new emails to be sent to.
  4. Scroll to the bottom of the form and click Advanced Settings to open the panel.
  5. Check Send custom fields when adding subscribers to my mailing list
  6. Add the name of the custom field. This is the name your mailing list provider calls the field, which may be something like MMERGE7.
  7. Add the value next to the custom field. This is the data BookFunnel will pass along with the subscriber’s email and it can be the book title, promotion name, or even a variable like {{date_time}}. Learn more about variables.
  8. Click Save and Close.

Constant Contact Custom Fields

Constant Contact has some limitations when sending custom field data through the API (the API is how BookFunnel sends data to your Constant Contact account). While you can create custom field names on your Constant Contact dashboard, their API does not allow custom field names.

What does this mean for you? It means that BookFunnel can pass along custom data, but the field name must meet Constant Contact’s API requirements. So, you can’t call the field name “book title”. Instead, you will call the field name “custom_field_8” (the number can be any number between 1-15).

Example: You want to send the book title when BookFunnel adds new email addresses to your list. First, you will create a field name in Constant Contact that their API will accept. Second, you’ll add that field name to the advanced settings panel on the BookFunnel email signup page.

Constant Contact’s Dashboard

Field type: Text

Field Name: custom_field_12 (You must use this structured “custom_field_#” as the field name, not a personalized field name. Constant Contact’s API will not accept any field name other than “custom_field_#)

Advanced Settings on BookFunnel Email Signup Page

Name: custom_field_12

Value: Wuthering Heights

When a new subscriber signs up through your opt-in landing page, BookFunnel will add their email address and “Wuthering Heights” to the field name custom_field_12.


Why isn't my data showing up?

The field must exist on your mailing list before we send the value. If the field does not exist, or the field name added to your email signup page does not exactly match the field name on your list, your list provider will not add the additional data to the subscriber. Verify that the field names match and that your list provider isn’t using an alternate field name like MMERGE7 or .

I checked the box to send custom fields and now it says “Source”. Can I delete “Source” and add something else?

You can delete the Source field or edit it to match the fields you have already created on your mailing list.

How do I find the name of my MailChimp field?

MailChimp allows you to set the “Field label,” but the merge tag is usually something like MMERGE9. The merge tag (not the field label) should be used on the BookFunnel email signup page.

To find the name of the merge tag, view your list on your MailChimp dashboard. Click Settings and then select “List fields and *|MERGE|* tags”

Locate the field label and then find the tag on the right. The tag should be copied and pasted into the BookFunnel email signup form under Advanced Settings.

Can I collect custom reader data like their birthday or favorite dessert?

This feature does not allow you to create new form fields. BookFunnel will only request the reader’s email address, and optionally their first and/or last name. These custom fields can be used to pass “secret fields”, which can be used for tracking purposes or segmenting subscribers.

Was this article helpful?