Custom Fields & Mail Merge

Last updated April 16th, 2018

Custom Fields & Mail Merge FAQ:

PHP Fatal error: Allowed memory size of XXXXXXXX bytes exhausted

If you are seeing a php error similar to: "xxxxxxxx bytes exhausted", then you can increase the allowed memory limit in php to get past the error:

  1. Open init.php located at /admin/com/init.php for editing
  2. Go to line 217 (or search for "memory_limit")
  3. Change the '64' in iniset('memorylimit', '64M'); to a higher value than your error message.

E.g. If your error looks like "67108864 bytes" try something like: iniset('memorylimit', '128M');

How can I add custom fields to my newsletters or templates created outside of Interspire Email Marketer, eg. in Frontpage or Dreamweaver?

Simply copy the tags used in Interspire Email Marketer into your HTML file to add these custom fields.

So to begin, create a dummy newsletter in Interspire Email Marketer and click on the "Insert Custom Field" option. A new window will pop open with a list of the custom field options you can enter. Simply copy and paste the custom field you would like to use in your newsletter.

eg. %%UNSUBSCRIBE%%

Keep in mind however, that when you preview a newsletter, i.e. Send it to yourself using the preview option, the custom fields will not be parsed, because your preview email address does not contain the custom fields. In order for the custom fields, including unsubscribe to work, you must send the newsletter out to a contact list. If you'd like to test this, simply create a test contact list, add yourself as a contact and send the newsletter to that contact list.

Why do my custom fields not show up when I send a test email or autoresponder?

Your test emails will only display the place holders for your custom fields as there is no contact list or contact linked to the test email for Interspire Email Marketer to draw the information from.

If you wish to see what your email will look like with your custom fields filled in you can add yourself to the contact list that you are sending to and then send yourself an email from there. This will display your own information in place of the place holders.

What are custom fields and why/how would I use them?

Custom Fields or Mail Merge Fields are used by you to personalise your emails to your customers. You can also use these fields to filter your sends so that only particular contacts receive the email depending on the details that they have saved for themselves.

How do I create custom fields?

The first step in using custom fields is to have a contact list created. When you have created this contact list you can then go to the menu option 'Contact List' and select 'View Custom Field' from there.

This will bring you to a page for viewing, editing and creating any custom fields you have already created or are planning on creating. Here you will need to select the 'Create a Custom Field' button.

This will start you through the creation process. You will have to select the type of custom field you want and name it so that you can use it in your Email Campaigns and Autoresponders. If you select to make the field 'Mandatory' your users will not be able to complete the form without entering these details.

The types of custom fields are:

  • Text Field - Use this to gather small amounts of information about your contacts. This could be their First Name or Last Name etc. You can then use this custom field to personalise your emails by opening with something such as 'Dear %%First Name%%'.
  • Multiline Text Field - This type of custom field is good for gathering larger amounts of data from your contacts such as having them send you comments on your products or service. (If you set the website form you create to 'Emulate a contact form' you will be sent an email with these comments when any user fills out the form).
  • Numbers Only - Using this type of custom field can be good for gathering information such as phone numbers.
  • Dropdown List - This type of custom field allows your user to select only one option from a predefined list of options. You could use this to ask for your users title such as Mr, Mrs or Miss.
  • Check Box - Check boxes allow your users to select multiple options. You could use this to request information on what your users favorite things are such as their favorite style of music. This will then allow you to filter your email sends to only those users that have selected Rock and those that have selected Jazz rather then sending irrelevant information to those users that do not like these genres.
  • Radio Button - You can use this in just the same fashion as the dropdown list but have it set out differently in your form. It will still only allow your contact to select one option from a predefined list.
  • Date Field - Using a date field will allow you to gather information such as Birthdays of your users.

When you have selected your type of custom field and named it you can move onto the next step. This step will have options such as 'Default Value', 'Field Length', 'Start Date' and so on. The most important of these is the Default Value. You can use this so that if your contact does not enter a value but you still wish to use this custom field in your email campaigns you do not have to worry about emails looking strange.

If you send an email that states 'Dear %%First Name%%,' and your user has supplied the name John you will send an email that reads 'Dear John,'. If you have set a Default value of 'Friend' and your contact does not save his/her name your email will then read 'Dear Friend,' rather then 'Dear ,'.

Using your Custom Fields with Website Forms.

When you create a website form using a contact list that you have created custom fields for you will be shown a list of those custom fields that you can then choose to include in your form.

Adding these fields to your forms will allow your contacts to inform you of their details and modify them via a modify details form.

Viewing and editing your custom fields.

To view what details are stored in your contacts custom fields you have 2 options. The first is to export your contact list and view the list of contacts as a CSV (Comma Separated Values) file. To do this you simply have to select 'Contacts->Export Contacts to a File' from the menu. When you do this you will be given the option to select which contact list you wish to export and which custom fields associated with that contact list to include in this export.

The second option is to view the list of contacts through the 'Contacts->View Contacts' menu. When you have found the contact that you wish to view/edit the detials of simply select the 'Edit' link next to their email address and you will be shown the information that that particular contact has saved on themselves.

If this method of editing contact information is too slow then you can either import the contact list again with updated information, choosing to update the current information to the imported file, or you can send a 'Modify Details Form' to your contacts.

Using your Custom Fields in your Email Campaigns and Autoresponders.

When you create your email campaigns and autoresponders you will see an option, in the WYSIWYG editor, below the WYSIWYG editor and below the text box for text based email content, that reads 'Insert Custom Field'. When you select this option you will be presented with a pop up window that contains a list of all the built in custom fields and then a listing of all the user created custom fields listed by contact list.

When you decide which custom field that you wish to insert into your email campaign, click the insert link and it will be placed where the cursor was located.

This will look similar to %%Custom Field Name%% when you insert this into your email campaign. When you send your email to your contact list any details that they have saved for those custom fields will be inserted into the email in replacement of the %%Custom Field Name%%

Remember that sending a test email campaign will not replace the custom fields. Your emails will still come through with the custom field place holders to show what your email would look like.

Another thing that you should make sure to remember is that custom fields are associated with contact lists. This means that if you send an email to a contact list that the custom fields are not associated with they will not be replaced and your email will not look correct. Be sure to use custom fields for the mailing list that you intend to send it to.

Do you handle merging of information in order to send personalized e-mails?

Yes. You can create custom fields such as 'Name', 'Address', 'Date of Birth', 'Phone Number' or even 'Preferred Food' that you could set up as multiple check boxes.

You can set up default details for these custom fields so that they have default values so that your emails never send out blank fields. ie Dear Friend if they do not add their name.

Or you could use the check box fields to send emails to all your contacts that like Roast Meals.

If my contacts don't enter their first name what happens to their custom fields?

When you create your custom field you can set up a default value for that custom field. If you choose then not to make the field mandatory, then it will be set as the default if the contact does not enter their own details.

By this I mean, if you set up a custom field 'First Name' and set the default value as 'Friend' then if your contacts do not add their first name it will be saved as 'Friend'.

When you then create your email campaign and enter 'Dear %%First Name%%' then you will always have a name displayed in your email. Either: 'Dear John' or 'Dear Friend'

Can I add custom fields to my Email subject lines?

Yes you can. You simply need to add the correct place holder such as '%%First Name%%' in your subject line and they will be replaced when the email is sent.