Please visit our current knowledge base at

How to use custom tokens

If you've been assigned a custom token by Barilliance, you can use it freely anywhere in the email template. This includes the subject line, main template or advanced widget section.

A custom token may not always have a value. For example a token that holds the visitor's name will be empty if the system was not able to capture the name. You can still use the token in the email but nothing will be printed. It's possible to assign a default value to a token in the case that it is empty. If the token is empty the default value will be printed instead. A default value may look like this:

Dear %@name=customer@%

In the above example if the name token doesn't have a value then the word "customer" will be printed instead.

When sending yourself test emails all tokens will be empty. If you would like to see them displayed you must either use a default value as explained above or (recommended) assign values in the Set custom parameters for test emails section in the rule setup.


Testing With Real Data

If you want to test the tokens with real data you can activate the rule in BCC mode where the email rule is live but the emails are sent to a en email address you specify instead of to your visitors.


Advanced Use (not needed in the majority of cases).

Sometimes it is convenient to only print a particular section of the email if a certain token has a value. This is useful if you've been assigned sequential tokens, where each token may correspond to one item in the cart. In that case each token will be numbered (e.g name0, name1, name2 etc...) but not all visitors will have a full set of tokens. It is possible to do so by setting a token if condition. A token if condition looks like this:

<!--[@prod_name7] -->
content that needs to be printed will go here
<!--[/prod_name7] -->

In the example above anything between <!--[@prod_name7] --> and <!--[/prod_name7] --> will be printed only if the token prod_name7 is not empty.