SendMailer Pro tutorials

Import contacts from Excel, personalize your message and prepare a document for each recipient. Follow the written example with practice files, or choose a video for a specific task.

From Excel contacts to personalized emails and PDF attachments

Follow two fictional contacts from a spreadsheet to an email preview, then reuse their data in a personalized document attachment. First complete the template exercise without a sending account. The optional campaign steps require an account already configured in SendMailer Pro.

1. Import contacts from Excel or CSV

Download the Excel and CSV practice files (ZIP, 6.3 KB). Extract the ZIP and open the README. The two rows use reserved example.com addresses for preview only.

Practice data — one row per contact
EmailFirst NameCompany
anna@example.comAnnaNorthwind Demo
mark@example.comMarkContoso Demo
  1. In Contacts, choose New List and name it “Personalization example”. Select the new list, choose Import Contacts, and open contacts.xlsx. The CSV version contains the same data.
  2. Select cells A1:C3, including the header row and both contacts, then choose Import Selected. Answer Yes when asked whether the selected columns contain headers.
  3. Drag Email from the imported columns on the left onto E-mail on the right. Select First Name on the left and choose Map selected column and add to contact list; keep the suggested name and choose Ok. Repeat for Company, then confirm the completed mapping with OK.
  4. Check that both contacts appear. If they are inactive, choose Selection → Select All → Activate and confirm the two selected contacts. The template preview uses active contacts.
SendMailer Pro contact list with two active fictional contacts, Anna and Mark, and First Name and Company columns.
Two active contacts, with the fields needed by the template. Select the image to enlarge it.

2. Insert real merge fields

  1. Open Templates, choose New Template, enter a name and confirm it. Select the template and choose Edit Template. If a blank template offers an email layout, choose No for this simple text example.
  2. At the bottom of the editor, open Contact List and double-click “Personalization example”. If Preview merged data is enabled, turn it off while inserting fields.
  3. Type “Hello ”, open Insert merge field and select First Name, then add a comma. On a new paragraph, type “Here is the project update for ”, insert Company from the same menu and add a period.

The template should read “Hello «First Name»,” and “Here is the project update for «Company».” Insert the fields through the menu: typing the angle brackets and field names as ordinary text does not create merge fields.

3. Preview both contacts

Enable Preview merged data. Use First record and Next record to inspect both contacts. In this example, the same template produces:

Expected values in the two previews
GreetingCompany
Hello Anna,Northwind Demo
Hello Mark,Contoso Demo
SendMailer Pro template preview showing Hello Anna and the company Northwind Demo.
The email preview uses Anna and Northwind Demo. Next record switches to Mark and Contoso Demo.

Choose Save and Close. When you reopen the template, its merge fields remain available for reuse. Select the contact list again when you want to preview its data.

If the editor says “no active contacts”, check the selected list and its Active column. If it reports missing merge fields, compare the field names in the template with the columns in that list. For an empty value, check the corresponding contact’s data.

The template exercise stops at preview and does not require a sending account. Continue below when you want to prepare a personalized document attachment for a campaign.

4. Add a personalized PDF attachment

A dynamic attachment uses a template and replaces its merge fields for each recipient. For this exercise, reuse “Personalization example” to check the same name and company in a document. In your own work, you can prepare a separate document template for a project update, confirmation or welcome pack.

  1. In Campaigns, choose New Campaign. Select your contact list and email template, then assign an account you have already configured.
  2. At Step 4 — Add Attachments, open Add attachment and choose Add dynamic PDF attachment.
  3. Select the saved template and choose Select. Check that the attachment row shows Dynamic Pdf and the .pdf extension.
  4. Select the attachment and choose Preview selected attachment. Use Next Record to inspect both contacts, including names, company details and page layout.
SendMailer Pro campaign wizard with a Dynamic Pdf attachment made from the Personalization example template.
A dynamic PDF attachment references a saved template. The screenshot uses fictional demonstration data.
Personalized document preview for Mark at Contoso Demo in SendMailer Pro.
Mark’s document preview contains his name and company. Check Anna’s record too before proceeding.

Choose the attachment type for the job. Add attachment from file attaches the same existing file to every recipient. Dynamic PDF, Word and text attachments generate recipient-specific content from a template. This workflow does not select a different existing file from a path in each spreadsheet row.

5. Review before sending

  • Check the selected list, active contacts, template, subject and sending account.
  • Preview both the email and each dynamic attachment. A correct email preview does not replace checking the document layout.
  • Resolve missing fields and empty values in the contact list. Keep the field names consistent across the email and attachment templates.
  • For your own campaign, send a test to an address you control and verify the received message and attachment before sending to your intended recipients. Follow your provider’s sending limits.

The downloadable sample is for preview only. Replace its reserved addresses with your own test data before sending. For account setup, follow Adding Email Sending Accounts; for the full campaign workflow, see Creating and Sending an Email Campaign.

Watch the template walkthrough

Video tutorials

Watch on this page after choosing the required cookies, or use the direct YouTube links.

01. Adding Email Sending Accounts

4:24

Learn how to add and configure email sending accounts in SendMailer Pro, including standard SMTP accounts and Microsoft Outlook or Microsoft 365 sign-in.

To watch here, enable Functional, Analytics and Advertisement cookies in Cookie preferences, or use the YouTube link.

Watch on YouTube ↗

02. Creating and Managing Contacts

3:32

Learn how to create and manage contact lists in SendMailer Pro and prepare recipient data for personalized email campaigns.

To watch here, enable Functional, Analytics and Advertisement cookies in Cookie preferences, or use the YouTube link.

Watch on YouTube ↗

03. Creating personalized email templates

3:31

Learn how to create and edit reusable email templates in SendMailer Pro and add personalized content for recipients.

To watch here, enable Functional, Analytics and Advertisement cookies in Cookie preferences, or use the YouTube link.

Watch on YouTube ↗

04. Creating and Sending an Email Campaign

5:27

Learn how to create an email campaign in SendMailer Pro, choose its contacts and template, preview messages and manage sending.

To watch here, enable Functional, Analytics and Advertisement cookies in Cookie preferences, or use the YouTube link.

Watch on YouTube ↗

Connect a MySQL contact list

Read contacts directly from an existing MySQL table or view without repeatedly exporting a spreadsheet. The connection is one-way and read-only: SendMailer Pro does not change the source database.

Before you begin

Ask your database administrator for the server name, port, database name, a read-only SELECT account and the correct TLS settings. The source needs a stable, unique contact ID and an email address column. Keep TLS enabled; a local network alone does not guarantee a secure connection.

  1. In Contacts, open the arrow beside New List and choose Connect to database (MySQL)….
  2. Give the list a recognizable name and enter the connection details. Choose Test connection and continue.
  3. In Source and columns, select Table or View and choose your source. Select the Contact ID column and Email address column. You can also type exact names; the preview checks them against the source.
  4. Expand Additional contact fields (or Personalization fields, depending on your app version). Choose Add field for each extra column you want in the contact list. Select its source column and enter a Field name (called Merge field name in earlier versions).
  5. Choose Check mapping and preview. Review the sample and select automatic updates before sending or manual refresh using the last saved contacts.
  6. Choose Create list and load contacts. Wait for the full update, review the completion counts, then choose Close. This loads contacts; it does not send email.
Example additional contact fields
Source columnField name in SendMailer Pro
firstnameFirstName
lastnameLastName

The Field name is both the column heading in your contact list and the name available for personalized emails. Enter a unique name without brackets; do not use reserved names such as E-mail, NowDate, Active or LastSent. Finding four available source columns does not import all four: only columns you explicitly map are included. You can also use a list with no additional fields.

Table or view? A table supplies all its rows without a filter in this dialog. Use a view for database-side filtering. If your source has an activity flag, map the optional Active column explicitly; 1/true means active, while 0/false, empty or NULL means inactive. Local deactivation, invalid addresses and the blocklist can still prevent sending.

Add columns to an existing linked list

Select the list in Contacts. Below the contacts, next to Refresh contacts from source, open MySQL connection settings, then Source and columns. Add the fields, choose Check mapping and preview, then Save and update contacts. Wait for completion before closing. Settings are temporarily unavailable while the list is being refreshed.

Edit Columns is for local lists, not linked MySQL lists. Edit List changes the name and notes. You do not need to edit a template to display the new columns in the contact list.

Use the values in an email

Open Templates, edit a template and select the linked Contact List. Place the cursor in the message body, choose Insert merge field and select FirstName or LastName. Use Preview merged data to check different contacts. The editor inserts a real merge field; typing [FirstName] as ordinary body text does not create one. In a campaign subject, use the supported placeholder [FirstName]. Keep field names consistent with your templates.

Read when linked contacts are refreshed, including scheduled sends, Continue and Retry Failed. Scheduled sending requires SendMailer Pro to be running and the PC awake and connected.

For an optional sending provider, see using Amazon SES through SMTP and monitoring results in AWS. These are separate from the MySQL connection.

Need a hand?

Find an answer in the SendMailer Pro FAQ or contact support.