Composing your first campaign

In this chapter we will talk through composing and sending a very basic email campaign, which contains a simple piece of news and a single image

For this example we are going to use the campaign phpList LTD sent out when version 3.4.0 was released. This campaign contains the new features for this release and the contributors who made possible.

Getting Started

To start a new campaign in phpList, navigate to Campaigns > Send a campaign from the main menu.

phpList main menu Campaigns tab "Send a campaign"

This will open up a three-tab dialogue which will guide you through the build-and-send process. Please note that various settings and plugins add more tabs.

Message composition of the campaign is done in the first tab - the Content tab.  

The Content Tab

There are three tasks to complete in this tab. You must write your subject, edit the From line and create your message in the compose message window.

Subject line

The subject of the email is the first thing that your subscribers will see, so it's very important. Make sure that your subject line:

  • Is honest about the content of the email
  • Avoids spammy sounding words or phases (Free, hot, opportunity, risk free, etc)
  • Is less than 50 characters long if possible
  • Is eye-catching and appealing
  • Is easy to understand, with a clear meaning or appealing hint
  • Contains a "call to action" if possible/appropriate (so Read, Buy, Sign, Donate)

Sometimes you will have to compromise, prioritizing some of these points above others.

The From Line

The second step is to edit the From line - your subscribers will also see this information. In phpList this information is usually auto-filled from settings in your system configuration, and is formatted Name [space] email. In this case the automatic information was originally:

We changed it to " phpList" so its more friendly.

phpList edit the from line, edit the sending email

We allowed replies to this email because we always appreciate feedback, however, you may wish to use a "" style email: this depends on the number of replies you tend to get, what they are about, and the purpose of the email.

For detailed information about formatting the From line click in the information button next to it.

The Content

The next step is to compose your message. In this example, we will compose the message directly in the phpList Content window.

Assuming you have your What-You-See-Is-What-You-Get (WYSIYWG) composer plugin installed and enabled (usually FCKEditor) you will be able to edit in a way that is similar to a Word-Processor or a blog site. In the example below, we have composed our text, and are using the Italic button to draw attention to some text.

how to compose a message in phpList

Adding an Image

The simplest way to add an image to your campaign is to embed one from your website, or from an external source such as Wikimedia Commons. To do this you need to find the URL of the image from your site.

Depending on your browser, this may be done by right clicking on the image and clicking Copy Image Location or similar (in Internet Explorer it may be under right click Properties).

how to select an image url

Then, in your phpList window click the Insert/Edit Image button in the WYSIWYG toolbar.

inserting an image in your campaign phpList

You will then see the Image Properties dialogue.

Paste the image url into the URL box by using control-v or right click Paste. You should see the image in the Preview box below. If there is an error, the most likely culprit is the URL.

image properties phpList

Image formatting and metadata

You should include an Alternative Text for the image. This will show in place of the image when the image is suppressed by the recipients email software, which is quite common. A good alternative text helps encourage your reader to decide to view the images in the email: this in turn makes your Campaign Statistics more accurate.

You may also wish to change the display size of the image: We chose a Width of 600, and the height was adjusted automatically because the Lock Ratio padlock is locked). You can also chose to Align the image, in this case they chose Right, to make it display on the right hand side of the email. They also gave it an HSpace and VSpace of 5, which added 5px (just a little bit) of space between the email text and the image.

Once you are done, click OK.

an image in phpList campaign

You will now see the image displayed in your email. If you wish to edit it again, right click the image and click Image Properties.

edit an image in phpList

Creating a Text Link

Now a link to the download page is needed to show subscribers where to download the new version of phpList . To create a link, first highlight (with your cursor) the bit of text that you want to become a link:

how to make a text link in phpList

Next you click the Inset/Edit Link button

edit/insert link button in phpList

Finally, you paste the URL of the page you wish to link to into the URL box, and press okay.

phpList enter url for text link

When your subscribers receive your mail they will see the link, as below, and will be able to click the text to go directly to your website. In your campaign statistics you will see how many clicks you had.

a text link in phpList campaign

Note that links which use the URL which they point to as the link anchor text will not be tracked by phpList. This is because link-tracking requires automatic link rewriting, but doing so would result in a link which would trigger spam filtering systems. Therefore links like this will not be tracked on statistics pages

Once you have finished composing your message, you are ready to move onto sending your campaign.

Test your campaign 

It is easy to skip this step because sending the mail is so exciting, but it is really important to check... and after all, it only takes a few minutes.

To send a test you need to enter your email into the Send text box at the bottom of every screen in the campaign workflow. You can send multiple test emails by separating the addresses with a comma - it is a good idea to test in both Webmail (like GoogleMail) and a client (like Thunderbird).

All the emails you send a test to must already be on one of your lists: if they are not, you will be prompted to add them.

Once you have entered the email, click Send test

Check that the

  • formatting is displaying as expected
  • your links go to the right places 
  • you have not made any spelling errors. 


If you find a mistake, edit your campaign and test again. Once happy with your text part of your Campaign, click on the Next button.

phpList click next


Discuss this chapter here.