Getting started

What’s New

Roadmap

Octeth Training Program

Installation & Setup

Requirements

Architecture

Server Setup

Oempro Installation

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Video Tutorials

Administration

Quick Walkthrough

Security

Sub Admin Accounts

Settings

Delivery Servers

Global Segments

Global Custom Fields

Bounce Processing

Spam Complaints

Suppression List

Plug-Ins

Delivery Report

User Management

Maintenance

Audience Management

Introduction

Subscriber Lists

Custom Fields

Segments

Subscribers

Webhooks

Website Event Tracking

Email Marketing

Introduction

Auto Responders

Email Campaigns

Sender Domain Man.

Journeys (Automation)

Bounce Processing

Email Personalization

FBL Processing

Email Builder Integrations

Email Deliverability

Sender Domain Management

Plug-Ins & Add-Ons

AI Plug-In

RSS Plug-In

Bounce Catcher Add-On

Link Proxy Add-On

Developers

Introduction

Single Sign On

API

Plug-In Development

Database

Advanced

Reverse Proxy

Cookbook

Help

Troubleshooting

Contact Us

Email Personalization

Personalized emails stand out within the inbox as highly relevant, tailor-made material. Personalized emails make an email more likely to be opened and clicked on, and most importantly, personalized emails strengthen customer experiences by sending the right content to the right people at the right time.

when creating an email campaign or auto responder email, you can personlize following email parameters:

• Email subject
• HTML email body
• Plain text email body

Email Subject Personalization

When you click on the email subject, a personalization drop down will appear below the subject line:

HTML Email Content Personalization

In order to personalize the HTML content, simply click “Personalize” menu item on the toolbar and click the attribute you would like to insert:

Plain Text Personalization

Once you convert your HTML email content into plain text version with a single click, you can click on the plain text email editor and the personalization drop down list will be displayed below the text editor:

Stripo Drag-n-Drop Email Personalization

When creating your email in Oempro using the Stripo drag-n-drop email builder, click “Merge Tags” to insert subscriber attribures, special merge tags or links into the email:

Special Merge Tags

In addition to subscriber attributes, you can personalize the email content and subject with the following special merge tags:

Special Links

You can also insert some system links into the email content:

Conditional Personalization

Starting from Oempro v5.0.0 version, we have introduced a brand new personalization engine and email content tags. We will remain our legacy personalization engine until Oempro v6 version release.

This new personalization engine introduces new syntax. From now on, instead of %...% syntax, the brand new {{ ... }} syntax will be used.

Here’s an example:

{{ Subscriber:EmailAddress }} will be replaced with the email address of the recipient.

In addition to standard personalization, our new personalization engine includes powerful conditional personalization.

Whitespace

Whitespace before or after the delimeters is allowed, however, in certain cases, whitespace within the tag is prohibited (explained in the following sections).

Some valid examples:

{{name }}
{{name }}
{{name}}
{{name  }}
{{
name
}}

Some invalid examples:

{{na me }}
{ {name} }

Comments

You can add comments to your templates by wrapping the text in {{# #}}.

Example

{{#This will not be parsed or shown in the resulting HTML #}}

{{#
They can be multi-line too.
#}}

Prevent Parsing

You can prevent the parser from parsing blocks of code by wrapping it in {{ noparse }}{{ /noparse }} tags.

Example

{{noparse }}
    Hello, {{name }}!
{{/noparse }}

Basic Example:

{{#Parsed: Hello, World! #}}
Hello, {{name }}!

{{#Parsed: <h1>Oempro is Awesome!</h1> #}}
<h1>{{title }}</h1>

{{#Parsed: My real name is Oempro User!</h1> #}}
My real name is {{Subscriber:FirstName }} {{Subscriber:LastName }}

Conditionals

Conditionals in Oempro are simple and easy to use. It allows for the standard if, elseif, and else but it also adds unless and elseunless.

The unless and elseunless are the EXACT same as using {{ if ! (expression) }} and {{ elseif ! (expression) }} respectively. They are added as a nicer, more understandable syntax.

All if blocks must be closed with the {{ endif }} tag.

Variables inside of if Conditionals, do not, and should not, use the Tag delimeters (it will cause wierd issues with your output).

A Conditional can contain any Comparison Operators (==, !=, ===, !==, >, <, <=, >=). You can also use any of the Logical Operators (!, not, ||, &&, and, or).

Examples

{{if Subscriber:FirstName }}
    <p>My name is {{Subscriber:FirstName }} {{Subscriber:LastName }}</p>
{{else }}
    <p>I don't know what my name is</p>
{{endif }}

{{if Subscriber:CustomField18 == 'customer' }}
    <p>You are a Customer!</p>
{{elseif Subscriber:CustomField18 == 'trial' }}
    <p>You are a trial User.</p>
{{else }}
    <p>I don't know what you are.</p>
{{endif }}

{{unless age > 21 }}
    <p>You are too young.</p>
{{elseunless age < 80 }}
    <p>You are to old...it'll kill ya!</p>
{{else }}
    <p>Go ahead and drink!</p>
{{endif }}

The not Operator

The not operator is equivilent to using the ! operator. They are completely interchangable (in-fact not is translated to ! prior to compilation).

Undefined Variables in Conditionals

Undefined variables in conditionals are evaluated to null. This means you can do things like {{ if foo }} and not have to worry if the variable is defined or not.

Checking if a Variable Exists

To check if a variable exists in a conditional, you use the exists keyword.

Examples

{{if exists Subscriber:CustomField100 }}
    Foo Exists
{{elseif not exists Subscriber:CustomField100 }}
    Foo Does Not Exist
{{endif }}

You can also combine it with other conditions:

{{if exists Subscriber:CustomField100 and Subscriber:CustomField100 !== 'test' }}
    Something here
{{endif }}

The expression exists foo evaluates to either true or false. Therefore something like this works as well:

{{if exists Subscriber:CustomField100 == false }}
{{endif }}

JSON Custom Fields

If the subscriber custom field value is a JSON data, the personalization engine can detect this and you can personalize your email content with any values inside the custom field.

For example, if the custom field value is:

{"key1":"val1","key2":"val2","key3":"val3"}

You can personalize your email content with any of these values:

{{Subscriber:CustomFieldXXX:key2 }}

Helper Personalization Functions

You can modify email content and recipient info with the following helper functions.

• fn_strtolower()

Make a string lowercase.

Copy

{{ fn_strtolower value="TEST CONTENT" }}

• fn_fallback()

Make a string lowercase.

⚠️
The fallback personalization function is available in Octeth v5.1.0 and higher versions.
Copy

Hey {{ fn_fallback value="{{ Subscriber:CustomField1 }}" else="there!" }}

• fn_strtoupper()

Make a string uppercase.

Copy

{{ fn_strtoupper value="test content" }}

• fn_ucwords()

Uppercase the first character of each word in a string.

Copy

{{ fn_ucwords value="test content" }}

• fn_ucfirst()

Make a string's first character uppercase.

Copy

{{ fn_ucfirst value="test content" }}

• fn_trim()

Strip whitespace character from the beginning and end of a string

Copy

{{ fn_trim value="test content " }}

• fn_dateformat()

Format a Unix timestamp or YYYY-MM-DD date. Check this page for date format syntax.

Copy

{{ fn_dateformat value="1664651010" format="jS M, Y" }}
{{ fn_dateformat value="2022-10-03" format="jS M, Y" }}

• fn_time()

Return current Unix timestamp.

Copy

{{ fn_time }}

• fn_htmlentities()

Convert all applicable characters to HTML entities.

Copy

{{ fn_htmlentities value="test content &" }}

• fn_htmlspecialchars()

Convert special characters to HTML entities.

Copy

{{ fn_htmlspecialchars value="test content &" }}

• fn_lcfirst()

Make a string's first character lowercase.

Copy

{{ fn_lcfirst value="tESt cOnTEnT" }}

• fn_md5()

Calculate the md5 hash of a string.

Copy

{{ fn_md5 value="text to encrypt" }}

• fn_sha1()

Calculate the sha1 hash of a string.

Copy

{{ fn_sha1 value="text to encrypt" }}

• fn_number_format()

Format a number with grouped thousands.

Copy

{{ fn_number_format value="193002" decimals="2" ds="." ts="," }}

ℹ️
ds represents decimal separator, ts represents thousands separator.
• fn_wordwrap()

Wraps a string to a given number of characters.

Copy

{{ fn_wordwrap value="this is a very long email content which should be wrapped into a smaller one" }}

• fn_nl2br()

Inserts HTML line breaks before all newlines in a string.

Copy

{{ fn_nl2br value="line #1
line #2
line #3
line #4" }}

You can set the value of these helper functions to another personalization tag as shown in the example below:

{{ fn_strtoupper value="{{ Subscriber:EmailAddress }}" }}

On this page

• Email Personalization
• Email Subject Personalization
• HTML Email Content Personalization
• Plain Text Personalization
• Stripo Drag-n-Drop Email Personalization
• Special Merge Tags
• Special Links
• Conditional Personalization
• Whitespace
• Comments
• Prevent Parsing
• Conditionals
• The not Operator
• Undefined Variables in Conditionals
• Checking if a Variable Exists
• JSON Custom Fields
• Helper Personalization Functions