Skip to main content

Advanced templating

More template placeholders

This chapter contains additional details that may be useful for a designer who is creating a template for use in phpList. 


[SUBJECT] adds the subject of the email within the newsletter text.

[CONTENT] - a mandatory placeholder

This is where the message's content (body) will be inserted. Every template must have a [CONTENT] placeholder. 



[SIGNATURE] prints the phpList image signature.


[FORWARDURL] is replaced with the personalised URL only. To use this, you will need to wrap it in HTML, like this:

<a href="[FORWARDURL]">Forward to a Friend</a> 


[PREFERENCESURL] allows the recipient to edit their subscribe preferences, for example update their email or the number of lists they belong to. This essentially allows them to maintain your list up to date for you and is an invaluable feature. 

 [UNSUBSCRIBEURL] - a mandatory placeholder

[UNSUBSCRIBEURL] allows the recipient to totally unsubscribe from all your lists. In phpList you must include this placeholder somewhere in your body or footer. It is best to use this along side [PREFERENCESURL] if you manage multiple lists, so subscribers can leave just one list rather than all lists if they want.


Prints your domain, e.g. as listed in your configuration settings.


Prints the subscribers email address;

Some older placeholders

These are some older placeholders which still work, but are not recommended for use:


For example, if you use "If you want to forward this message to a friend click [FORWARD]", it will come out as:



Like Forward the link that subscribers can use to unsubscribe. It will also be replaced with "This Link", which means you can use it like this:

To unsubscribe from our newsletter click [UNSUBSCRIBE]


Like Forward and Unsubscribe the link that subscribers can use to update their personal details and preferences. It will also be replaced with "This Link", which means you can use it like this:

To change your preferences click [PREFERENCES]


Discuss this chapter here.