Campaign tags and filters

Tags

When creating a campaign, you are able to use a number of merge tags
Tags are placeholders that will be replaced with the actual content when the email is sent out. For example the [UNSUBSCRIBE_LINK] tag will be replaced with a clickable link that the recipient can use to unsubscribe themselves from your list.
All of your list's subscriber fields are available as merge tags, including [EMAIL], [FNAME] and [LNAME], as well as any custom fields you have added to the list.
Information about your list is also available as merge tags, for example [COMPANY_FULL_ADDRESS] will be replaced with your company information from the list settings.
There are also tags for automatically displaying information, for example [CURRENT_YEAR] will be replaced with the current year. 

Most common tags are listed below:

Tag Required
[UNSUBSCRIBE_URL] YES
[COMPANY_FULL_ADDRESS] NO
[UPDATE_PROFILE_URL] NO
[WEB_VERSION_URL] NO
[CAMPAIGN_URL] NO
[LIST_NAME] NO
[LIST_SUBJECT] NO
[LIST_DESCRIPTION] NO
[LIST_FROM_NAME] NO
[CURRENT_YEAR] NO
[CURRENT_MONTH] NO
[CURRENT_DAY] NO
[CURRENT_DATE] NO
[COMPANY_NAME] NO
[COMPANY_ADDRESS_1] NO
[COMPANY_ADDRESS_2] NO
[COMPANY_CITY] NO
[COMPANY_ZONE] NO
[COMPANY_ZIP] NO
[COMPANY_COUNTRY] NO
[COMPANY_PHONE] NO
[CAMPAIGN_SUBJECT] NO
[CAMPAIGN_TO_NAME] NO
[CAMPAIGN_FROM_NAME] NO
[CAMPAIGN_REPLY_TO] NO
[CAMPAIGN_UID] NO
[SUBSCRIBER_UID] NO
[EMAIL] NO
[FNAME] NO
[LNAME] NO
 

Filters

Filters are an advanced feature that are used to modify the output of a tag, such as changing a tag to all uppercase or applying URL encoding.

Filters are applied in this format: [TAG_NAME:filter:filtername]

For example to display the subscriber's first name in all uppercase letters you would use: [FNAME:filter:uppercase]

Another more advanced example: you might want to embed a sharing link to twitter in your campaign, say the campaign url itself.

Using only the tags you might embed it like this:

https://twitter.com/intent/tweet?text=[CAMPAIGN_SUBJECT]&url=[CAMPAIGN_URL]

But there is a problem, because twitter expects your arguments to be url encoded, and by that, I mean twitter expects to get:

https://twitter.com/intent/tweet?text=my%20super%20campaign&url=https%3A%2F%2Fapp.boltmail.nz%2Fcampaigns%2F1cart129djat3

But instead it will get https://twitter.com/intent/tweet?text=my super campaign&url=https://app.boltmail.nz/campaigns/1cart129djat3

In order to overcome this issue, we will apply the urlencode filter over our tags, therefore, the twitter url becomes:

https://twitter.com/intent/tweet?text=[CAMPAIGN_SUBJECT:filter:urlencode]&url=[CAMPAIGN_URL:filter:urlencode]

But we can do even more, let's say we want to make sure our twitter text starts with a capitalized letter and the rest of the letters will be lowercase.
In order to accomplish this, we can apply multiple filters(separate by a pipe) to the same tag, for example:

https://twitter.com/intent/tweet?text=[CAMPAIGN_SUBJECT:filter:lowercase|ucfirst|urlencode]&url=[CAMPAIGN_URL:filter:urlencode]

The order in which you add the filters is the same order that they are applied, the order can significantly affect the result.

Bellow is the entire list of filters:

urlencode will urlencode your tag
rawurlencode will rawurlencode your url
htmlencode will convert html tags into their entities
trim will trim the white spaces from begining and end of your tag
uppercase will transform your tag in uppercase only chars
lowercase will transform your tag in lowercase only chars
ucwords will capitalize each first letter from your tag content
ucfirst will capitalize only the first letter of your tag
reverse will reverse your tag content
  • 1 Users Found This Useful
Was this answer helpful?

Related Articles

How to add an unsubscribe link

All campaigns must include an unsubscribe link, there are several easy ways to do this: 1. Type...

How to log into BoltMail

To log into BoltMail go to: https://www.boltmail.nz And click the Login link at the top of the...

How to upgrade/downgrade your monthly plan

Log into this support portal (if you havn't already) by clicking the login link above....

Creating a sending domain

In BoltMail a verified sending domain allows us to prove to spam filters that you own the domain...

Getting started with BoltMail

The system is easy to use. Your first step should be to create a contact list, you can create...

Powered by WHMCompleteSolution