OneTrace.pro Help center

Templates and email builder

A template is a ready-made message for one channel: an email, a Telegram message, an SMS, a Web Push notification, a mobile push, an in-app message, a webhook, and others. The same template is used by journeys, campaigns, and manual sends from the profile card. Variables fill in the customer's name, the order total, and other data.

The section is in the menu under Engagement → Templates. All roles can view templates; Manager and above can create and edit them.

Create a template

  1. Open Templates, click New template in the top-right corner and pick the channel in the list: it contains every channel enabled in the project, for example Email or Telegram.
  2. Fill in the common fields (see the table below).
  3. Fill in the Content block. The fields depend on the channel. For an email, these are the Subject, Preheader (the text shown next to the subject in the inbox), Email builder or HTML, and the Plain text version. If you leave the plain text version empty, it's generated from the HTML.
  4. Click Save. Each save increases the version number (Version 3).
Field What it means
Name Visible only in the interface: in template, journey, and campaign lists
Channel Chosen at creation and can't be changed later
Subscription topic A topic from the list, for example marketing or news, or a new key, which will appear in the list. Customers can unsubscribe from just this topic
Transactional message Sent without checking subscription, frequency, or quiet hours, but not to a channel that is closed for the recipient: the mailbox or number doesn't exist, or the bot is blocked. Use it only for order confirmations, password resets, and similar messages. See Transactional messages and cascades

Template list

The table shows the channel, the template's language versions (the main language is highlighted in color), the deliverability rating, the subscription topic, and the time of the last change with the version number.

Deliverability is the overall result of the deliverability check of an email template across all its language versions: the worst rating among the versions ("Good", "Needs attention", "Poor") and the highest spam filter score (spam starts at 6). Details for each language and the check time are shown in the badge tooltip. The template is checked in the background after every change to the email; while the check is running, the badge says "Checking". Changing only the name or the subscription topic doesn't start a new check. If the rating is "Needs attention" or "Poor", open the template and run the check there to see the notes.

Above the table there's a search by name and filters by channel, language, and deliverability rating, for example all templates rated "Poor" or all templates with a German version. Clicking a column header sorts the table; clicking it again reverses the order. Filters and sorting are remembered: after you delete a template or come back from the editor, the list stays the same.

Template list with languages and deliverability rating

To delete a template, click the trash icon in its row in the list.

Variables

Templates are written in Twig. A variable goes in double curly braces. Expand the Variables block under the content to see the full list with examples.

Variable What it inserts
profile.email, profile.phone, profile.user_id Customer identifiers
traits.first_name and other traits.* Profile traits
event.name, event.properties.amount The event that triggered the message
context.data.*, context.nodes.* Journey data: passed on entry through the API, and the Webhook node's response
project.name, unsubscribe_url, preferences_url The project name, the unsubscribe link, and the link to the preference center
project.legal_address The company's legal address from the project settings; handy for the email footer. Empty if the address isn't set
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url The loyalty program account: balance, tier, expiring points and their date, the referral link
wallet_url A link to the loyalty card in Wallet: the customer adds the card to Apple Wallet or Google Wallet. Valid for 90 days; empty if Wallet cards aren't connected
promo_code('welcome') The customer's promo code from the welcome pool: issued on sending, a sample in previews
order.number, order.amount, order.tracking_url The order of a store email: number, amount, tracking link; amount with currency: {{ order.amount|money(order.currency) }}
product('SKU-1') A catalog product in the email's language: name, url, image, price, old_price, currency, available, stock, as of sending (product prices and availability)
Hello, {{ traits.first_name|default('friend') }}!
{% if event.properties.amount > 5000 %}Delivery is free.{% endif %}

Templates run in a secure sandbox. It supports if conditions, for loops, set, the date, min, and max functions, and filters such as default, date, upper, lower, capitalize, number_format, round, join, replace, striptags, and others. If a variable is missing, an empty string is inserted, so set a default where it matters. If you use a forbidden construct, you'll see the error The template uses a forbidden construct when you save. The rendered message can't exceed 512 KB. Template inheritance (extends, block) is not available, and loops and calls for products, recommendations and promo codes are limited: a template that does too much work won't be saved.

If a template contains a variable the platform does not know — a placeholder from someone else's layout such as {{ COMPANY_ADDRESS }} or a typo such as {{ first_name }} instead of {{ traits.first_name }} — a warning listing these variables appears above the content. They will be empty in the message. The warning is updated when you open the template, save it, preview it and send a test.

Preview and test send

  1. In the Preview panel, enter a profile ID, email, or user_id and click the eye icon. If you leave the field empty, data is taken from the most recently active profile.
  2. For an email, switch between the Desktop, Phone, Dark mode, and Images off views. In the last one, images are replaced with their alt text: this is how the email looks to recipients whose images don't load.
  3. In the Test send panel, choose an integration. Enter your own address or chat id; otherwise the message goes to the profile's address. Click Send test: the message status appears under the button.

Test sends are available to Manager and above. Subscription, frequency, and quiet hours aren't checked. The preview has no trigger event, so event.* variables stay empty. If you don't have permission to see personal data, email and phone are masked.

Template editor with a profile preview

Below the email in the preview is the In the inbox block. It shows how the sender, subject, and preheader look in the message list of Gmail on desktop, Outlook, and Mail on iPhone. A long subject and preheader are cut off roughly the way these clients do it. The sender name comes from the integration selected in the deliverability check block.

The email in the inbox of mail clients

Deliverability check

Before sending, you can check an email template to see whether the email will reach the inbox or land in spam. In the Deliverability check block, choose the integration the email will be sent through and click Check. The email is built the same way as when it is sent: with open and click tracking and an unsubscribe link. The open language version is checked, and data is filled in from the profile specified in the preview.

The check looks at three things:

  • Sender. For the OneTrace.pro mail service, the sender address domain must be added and verified in Sending domains, preferably with a DMARC record. For your own SMTP server, the domain's SPF and DMARC records are checked; the DKIM signature is set up at your mail provider and can't be checked from here.
  • Content. The subject (empty, in capital letters, with !! or $$, too long), the preheader, the email size (Gmail clips HTML larger than 102 KB), an email made of images only, images without alt, link shorteners, links to IP addresses and links whose text is the address of another site, a visible unsubscribe link in marketing emails, and elements that mail clients strip out (scripts, forms, frames).
  • Spam filter score. The whole email is checked by the Rspamd spam filter. A score below the "suspicious" threshold is good; above the "spam" threshold, the email will most likely land in spam. The What affected the score list shows the filter rules and their weights.

The result is one of the ratings: Good (no obvious reasons to land in spam), Needs attention (the email will arrive, but it is better to fix the notes), or Poor (high spam risk or a sender error). Each note explains what is wrong and how to fix it.

Below is Email client compatibility: layout techniques that don't work in Outlook for Windows, Gmail, Yandex Mail, or Mail.ru, for example rounded corners, shadows, media queries, custom fonts, SVG, and video. The email will arrive in these clients but will look different, so this doesn't affect the rating.

Email deliverability check

Campaigns check the emails of their variants in the same way. See Checking emails before launch.

Language versions

One template can contain versions in several languages. Each recipient gets the version in their profile language (the language trait), or the main version if there is no such version. The languages you can choose from are set in the project settings.

  1. Above the Content block, click Add language and pick a language. Then choose how to create the version:

    • Copy of the open version — layout, images and links are already in place, you only translate the texts;
    • AI translation — a draft translation of the main version, see below;
    • Import an email with AI — a ready-made email in this language, see Import into a language version.

    Choosing how to create a new version

  2. Switch between versions with the language buttons. The main version is marked "main".

  3. To give recipients without their own version a different language, open that version and click Make main. Delete version removes the open version.

  4. Click Save. Each version is checked separately; a version with errors is marked with a warning icon.

Draft translation

To avoid translating a version from scratch by hand, open it and click Draft translation. OneTrace.pro translates the main version into the language of the open tab: the subject, preheader, text of the builder blocks, the plain-text version, and the text of SMS, push, and messenger messages. Variables such as {{ traits.first_name }}, links, images, and styling stay unchanged.

The draft is only filled into the form. Read it, adjust the wording, and click Save. If a field can't be translated without losing its variables, it stays in the original language, and OneTrace.pro shows how many such fields there are. If the version already differs from the main one, you are asked before it is replaced.

The number of drafts per month is limited by your plan; see Plans. The button is missing if translation isn't enabled in your installation.

The version is chosen like this: an exact language match first, then the language without the region (a customer with pt-BR gets the pt version), then another variant of the same language. Preview and test send show the open version, and the {{ language }} variable contains the language of the version being sent.

Email builder

In an email template, click Open the builder in the Email builder field. If the template already has HTML, the builder starts the email from scratch, and the old code is replaced when you save. OneTrace.pro builds the code for email clients, including Outlook and phones, when you save.

To the right of the canvas there are three tabs:

  • Blocks: add a block. It's placed after the selected block, or at the end of the email before the footer.
  • Block: settings for the block selected on the canvas. You can move blocks up and down, drag, duplicate, and delete them.
  • Email: the background, email background, text and link colors, font, email width (480–800 px), padding, and how images are delivered.
Block Purpose
Heading, Text Formatted text with variables, for example {{ traits.first_name }}
Image An image from the media library: alt text, link, width 10–100%
Button Text, link, colors, and corner radius
Divider, Spacer A line and empty space
Columns 2–3 columns with headings, text, images, buttons, and spacers. On phones, the columns stack vertically
Products A selection from recommendations: personal, popular, Viewed together, Similar, and so on. For personal, popular, and trending products you can limit the selection to a catalog Category. The Selected products source shows up to 12 catalog products in the order you set: find them by name, and only the ones in stock make it into the email. You can show 1 to 12 products in 1–4 columns, with a price and a button. Products with reviews show a rating under the name. If there are no matching products, the block is left out of the email
Order The order from a store email: products, totals, parcel tracking, and addresses. Emails without an order don't show the block
Survey The main question of a survey: NPS buttons 0–10 or five stars. The customer gives a score right in the email, and the survey page saves it and offers the remaining questions
HTML Your own code as is
Footer Text, the unsubscribe link, and the “Manage subscriptions” link

Email builder with a selected block

The Switch to HTML button on the Email tab turns the email into plain code. After that, you can't go back to the builder.

Link (CDN) Attached to the email
Email size Light Larger by the size of the images
Display The image loads when the email is opened. If the mail client blocks images, only the alt text is shown The image is visible right away

The default is set in the Default image delivery field on the Email tab. For an individual image, you can change it in the Delivery field. All attachments of one email together can't exceed 1 MB. If public links aren't configured in your installation, only attachments are available.

AI in the email editor

AI helps with the text of an email template: it suggests subject lines, edits block text, and builds a whole email from a description. AI output is a draft: it goes into the form or the builder, and you are the one who saves the template. AI knows the project name, the store's industry, the currency, the language of the open version, and your brand voice and rules. Customer data is never passed to it.

AI is available on a paid plan and is charged to the project balance by usage. If AI is unavailable right now (trial period, empty balance, or spending limit reached), the buttons are still visible and the reason is shown next to them.

Subject ideas

The Subject ideas button is above the "Subject" and "Preheader" fields. Pick a Focus (different approaches, curiosity and clarity, urgency, personal touch, or benefit for the reader) and, if you like, write Wishes, for example "no emoji". Click Suggest: AI proposes five "subject + preheader" pairs based on the text of the open email version.

In the list, the subject is shown the way a recipient with a sample name would see it. The With the recipient's name label means the subject contains the name variable. The Use button puts the pair into the form.

Subject and preheader ideas

Editing block text

Select a heading, text, or button on the builder canvas. In the block panel, under AI: edit text, you'll find the buttons Shorten, Friendlier, More formal, Fix mistakes, and Rewrite…, which takes your own instruction. The AI suggestion appears under the buttons: Replace puts it into the block, Cancel leaves the text as it was.

AI doesn't change template variables or links. If a variable is missing from the answer or a link has changed, the text isn't replaced, and you'll see an explanation.

Editing block text with AI

Email from a description

The Email with AI button is above the builder, next to the "Open the builder" button. Describe what the email is about and what you want the reader to do, and include links, for example "coat sale until Sunday, up to 30% off, link https://…". Turn on Products from the catalog if the email needs products: AI looks at the catalog categories and finds products that are in stock. Click Build the email, which usually takes up to a minute.

To make the new email look like your other emails, choose an Example email: an email template of the project built in the builder. AI repeats its look and structure: colors and font, the logo and other images, buttons, HTML blocks such as a promo code box, and the footer with its variables. It writes the texts from the description: offers, promo codes and links of the example are not carried over unless you give them in the description.

The email is assembled from builder blocks: heading, text, button, products, and a footer with an unsubscribe link. If the builder already contains an email, OneTrace.pro asks whether to replace it. The subject and preheader are filled in only if those fields are empty. If something needs fixing, warnings appear above the builder, for example to add button links that weren't in the description.

Email built by AI from a description

AI creates email variants for an A/B test right in the campaign.

Import a ready-made email

If the email is already designed in another service, you don't have to build it again. On the Templates page, click Import email (AI):

  1. Choose File and upload an email saved from your mail app (.eml) or an .html page. Or choose HTML code and paste the email code.
  2. Click Import. AI usually needs up to a minute to process the email.
  3. The editor opens with a new email template: the email is split into designer blocks, images are copied to the media library, the recipient name is replaced with the {{ traits.first_name }} variable and the unsubscribe link goes into the Footer block. Texts and links stay as in the email.
  4. Review the template and click Save. The template doesn't exist until you save it.

Email import dialog

A template built from an email with AI

If part of the email couldn't be transferred, a list appears above the form: which images weren't copied or which blocks were skipped. If the email can't be split into blocks, it's imported as a single HTML block. Tracking pixels and the "View in browser" link are not imported.

OneTrace.pro detects the email language: from the lang attribute and the Content-Language header, and if they don't match the text, from the email text itself. The email language becomes the main language of the new template.

Import into a language version

If you already have the email in another language, you don't need to translate it: in an open email template, click Add language, pick the language and choose Import an email with AI. The email is uploaded the same way as when creating a template and goes into the version of the selected language, with its own blocks, images and subject. Review the version and click Save.

If the email language doesn't match the one you picked, a hint appears above the version, for example "The email seems to be in French", and a Make it the “French” version button. If that version already exists, OneTrace.pro asks whether to replace it.

Import is available on the Growth and Enterprise plans; the number of imports per month — both new templates and versions — depends on the plan, see Plans. On the Starter plan, the button shows which plan includes the feature.

Media library

The media library opens when you add an Image block or click Choose image.

  • Upload accepts JPEG, PNG, GIF, WebP, and AVIF up to 10 MB. Wide images are scaled down to 1200 px. WebP and AVIF are converted, because not all email clients display them. GIFs are kept as is, including animation.
  • Uploading the same file again doesn't create a copy.
  • You can't delete an image that's used in a template until you remove it from the template.
  • The space taken by images counts toward your plan's limit.

Media library with uploaded images