Retired Documentation:  You are using the documentation for version 1.7.3 which was retired in 2013. Go here for the latest version documentation or check here for your available upgrades to ExpressionEngine 3.

Mailing List Tags

ExpressionEngine comes with an integrated Mailing List Module.

The Mailing List is an opt in type, meaning that when someone adds their email address to the list, they are sent a confirmation email containing a link with an access code. Unless they click the link, their email address will not be added to the list. The opt-in link will expire in 48 hours. Conversely, when someone in your mailing list receives an email, there will be an "unsubscribe" link permitting them to remove themselves from the list.

To access the Mailing List backed functions, go to the Modules > Mailing List page in your Control Panel. There you will be able to create and manage your mailing lists, as well as find and delete email addresses. See Mailing List control panel for more information. To send email to any of your lists you will use the Control Panel Communicate Page.

Adding a Mailing List Form to Your Site

To add the mailing list form to any of your pages, use the following tag in any template:

{exp:mailinglist:form list="default"}

<p>Join our Mailing List</p>

<p><input type="text" name="email" value="{email}" /></p>

<p><input type="submit" value="submit" /></p>

{/exp:mailinglist:form}

Parameters

list=

list="default"

This parameter allows you to specify which Mailing List the email address will be subscribed to. This parameter takes the "short name" of the List as set in the Mailing List control panel. If no list is specified with the parameter then the "default" list is assumed.

Variables

email

{email}

This is the standard {email} global variable. Using this variable as the value of the email input field lets you automatically populate the field for logged-in members. Use as follows:

<input type="text" name="email" value="{email}" />

full_name

{full_name}

You may use this variable to display the full name of the Mailing List.

Top of Page