Tags are used to include event attributes such as name, country, province, etc.

Filters are simple methods that modify the output of strings and tags on notifications. They are placed within an output tag ###{{ }} and denoted by a pipe character |.

To check or modify the notifications settings, click on the Message section.

Here, you'll see the pre-defined filters and tags for the notification output:

In the following example, the tag is the first name of a customer:

In this example, the circled part is the highlight filter:

You can add the tag(s) you want to include by clicking on the options below:

To include a filter, simply add a | (pipe) after the name of the tag, then space (optional), and then the filter name. Filters are optional, used to customize the notifications. Example:
###{{ tag_name | filter_name }}

Multiple filters can also be applied to one tag:
###{{ tag_name | filter_1 | filter_2 }}

In the example below, multiple filters - title, link, highlight are included manually to customize the notification. (Find the detailed information about the filters below.)

1. Show random output from one of the provided arguments in case the tag value is empty

Fallback filters:

fallback default defaults

The fallback filter returns one of the provided arguments randomly in case of the tag value is empty.

###{{ tag_name | fallback: value 1, [value 2, ...] }}

Example:

input: ###{{ first_name | fallback: Someone, New buyer, A visitor, Lorenzo, John, Maria, Felix }}
output: A random argument

The fallback ( default and defaults ) filter accepts additional arguments to customize the output.

Arguments are included by adding a symbol after the name of the filter, then space (optional), and then argument value. To provide multiple arguments just separate them with a comma.

Example:
###{{ tag_name | fallback: arg1, arg2, arg3 }}

If the argument itself contains any of | (pipe), : (colon), , (comma), { } (curly brackets), then argument must be quoted (single or double quotes).

Example:
###{{ tag_name | fallback: "arg|ument," "argument:", "argument)", "{arg}ument", "argument, argument" }}

OR:

###{{ tag_name | fallback: 'arg|ument,' 'argument:', 'argument)',

'{arg} {ument', 'argument, argument' }}

The fallback filter has two additional alias (alternatives): default and defaults.

The following examples are the same:
###{{ tag_name | fallback: value }}

###{{ tag_name | default: value }}

###{{ tag_name | defaults: value }}

2. Show output in uppercase

Uppercase filters:
upcase uppercase

Example: consider the first_name value as Trace

input: ###{{ first_name | upcase }}
output: TRACE

3. Show output in lowercase

Lowercase tags:
downcase lowercase

Example: consider first_name value as Trace

input: ###{{ first_name | downcase }}
output: trace

4. Capitalize the output

Capitalization tag:
capitalize

Example: consider the title value as Blue tech sneakers

input: ###{{ title | capitalize }}
output: Blue Tech Sneakers

5. Show all the first letters of the output in lowercase

Example: consider the title value as Blue Tech Sneakers

input: ###{{ title | capitalize | downcase }}

output: blue tech sneakers

6. Show only the initial letters of the output

Initial letters tag:
initials

Get the first letter of each word and concat them to format the output text.

Example: consider the title value as Blue Tech Sneakers

input: ###{{ title | initials }}
output: BTS

7. Show only the first letter of the output

First letter tag:
first_letter

Example: consider the title value as Blue Tech Sneakers

input: ###{{ title | first_letter }}
output: B

8. Mask the output

Mask tags:
mask: *, 0, 0

Mask the value. Has 3 arguments and all of the optional.

argument 1: Mask symbol. Must be single character defaults to *
argument 2: Number of the characters that must be left as unmasked at the beginning of the string. Defaults to 0. Must be positive integer
argument 2: Number of the characters that must be left as unmasked at the end of the string. Defaults to 0. Must be a positive integer

Example: consider the title value as Blue Tech Sneakers

input: ###{{ title | mask }}
output: *****************

Example: consider the title value as Blue Tech Sneakers

input: ###{{ title | mask: *, 3, 2 }}
output: Blu************rs

Example: consider the title value as Blue Tech Sneakers

input: ###{{ title | mask: ., 0, 2 }}
output: ...............AG

Consider the first_name value as Justine:

input: ###{{first_name|fallback:Someone | mask: ., 0, 2}}

output: .....ne

9. Trim the name of the output before an argument

Trim before tag:
trim_before

The filter shortens the product name. Requires one delimiter argument. Truncates (shortens) the string before the first occurrence of the delimiter.

Example: considering the title value as Blue Tech Sneakers

input: ###{{ title | trim_before: Tech }}
output: Sneakers

10. Trim the name of the output after an argument

Trim after tag:
trim_after

The filter shortens the product name. Requires one delimiter argument. Truncates (shortens) the string after the first occurrence of the delimiter.

Example: considering the title value as Blue Tech Sneakers

input: ###{{ title | trim_after: Tech }}
output: Blue

11. Highlight the output

Highlight tag:
highlight

Use a highlight filter to highlight the tag or some portion of the string. You can include an optional argument as the background color. Argument value must be valid CSS color.

Example:

input: ###{{ first_name | highlight }}

input: ###{{ first_name | highlight: #fff6d3 }}

input: ###{{ first_name | highlight: 'rgb(255, 230, 230)' }}

Note: RGB color code must be single or double-quoted.

input: ###{{ first_name | highlight: "rgba(179, 215, 255, 0.3)" }}

Note: RGBA color code must be single or double-quoted.

You can add random or custom links to Sales notifications alongside highlight filters.

Random link:
link

Makes the tag output clickable. The Default link address is the value of the tag. But you can provide a custom link address as the first argument of the filter.

The second optional argument is for the target. You can use one of the following values:

Link opens in the same tab:
_self

Link opens in the new tab:

_blank

Link opens in the parent frame:

_parent

Link opens in the full body of the window:

_top

Example: consider the title value as Blue Tech Sneakers, and the link value as https://a.com/tech-sneakers

input: ###{{ title | link }}
output: a randomly linked document "Blue Tech Sneakers":

input: ###{{ title | link: https://a.com/tech-sneakers }}
output: custom linked document "Blue Tech Sneakers":

input: ###{{ title | link: https://a.com/tech-sneakers, _blank }}

or, ###{{ title | link: _blank, https://a.com/tech-sneakers }}
output: linked document - "Blue Tech Sneakers" opens in the new tab:

input: ###{{ title | link: _blank }}
output: a randomly linked document - "Blue Tech Sneakers" opens in the new tab:

input: ###{{ title | link: _parent }}

output: a randomly linked document - "Blue Tech Sneakers" in the parent frame:

input: ###{{ title | link: _top }}

output: a randomly linked document - "Blue Tech Sneakers" opens in the full body of the window:

Typos in any filters:

Typos in any filters will be ignored, and the output will be the original value

input: ###{{title | trimm_after: Tech}}

output: original value

Invalid tag name within an output:
If the tag name within an output tag ###{{ }} is not valid, then it will be used as a string. The following example is valid.

input: ###{{ invalid tag name }}
output: empty

input: ###{{ "invalid tag name" }}
output: invalid tag name