Přejít na obsah
Dokumentace

Reference

Šablonovací jazyk Temple

Temple při odeslání doplňuje proměnné, výchozí hodnoty a podmínky do předmětu, HTML a textu e-mailů. Syntaxe, pravdivostní hodnoty, escapování a kde Temple běží.

Aktualizováno 20. 10. 2026

Temple je malý šablonovací jazyk Emailitu pro předměty, HTML a prostý text. Není to Liquid ani Handlebars: podporuje proměnné, vnořené cesty, výchozí hodnoty a bloky if/else a nic dalšího. Šablony ukládají proměnné tak, jak je napíšete, a Temple je vyplní, když se e-mail odešle přes API, z automatizace nebo z kampaně.

Přehled syntaxe

Text
{{first_name}}                      Variable
{{user.name}}   {{items.0.sku}}     Nested property and list item
{{first_name|"there"}}              Default when the value is missing or null
{{#if plan}} … {{else}} … {{/if}}   Conditional, with an optional else

Temple nemá cykly, filtry, pomocné funkce, dílčí šablony ani vlastní funkce. Jediným operátorem je výchozí hodnota |.

Proměnné

Text
Hello {{first_name}}
  • Temple nahradí {{first_name}} hodnotou first_name, kterou předáte. Mezery uvnitř závorek se ignorují, takže funguje i {{ first_name }}.
  • Názvy rozlišují velká a malá písmena: {{First_Name}} neodpovídá first_name.
  • Chybějící hodnota nebo null se změní na prázdný řetězec. Neznámé proměnné zmizí, místo aby se v e-mailu zobrazily.
  • Hodnoty se převádějí na text. Čísla a logické hodnoty se zobrazí tak, jak jsou zapsané (42, true), a seznamy se spojí čárkami (z ["a","b"] vznikne a,b). Objekt se vykreslí jako [object Object], takže místo něj odkazujte na některé z jeho polí.

Vnořené vlastnosti a položky seznamu

Do objektů se dostanete tečkami a k pozicím v seznamu čísly od 0:

Text
{{user.name}}
{{order.items.0.sku}}
JSON
{
  "user": { "name": "Ada" },
  "order": { "items": [{ "sku": "A1" }, { "sku": "B7" }] }
}

Protože tečka odděluje části cesty, ke klíči, který sám obsahuje tečku, se dostat nelze. Používejte klíče bez teček.

Výchozí hodnoty

Přidejte | a náhradní hodnotu, která se použije, když hodnota chybí nebo je null:

Text
Hi {{first_name|"there"}},
Your company: {{company|'Not set'}}

Fungují dvojité uvozovky, jednoduché uvozovky i zápis bez uvozovek. Výchozí hodnota se nepoužije pro prázdný řetězec, 0 ani false; ty se vykreslí jako prázdný text, 0 a false. Výchozí hodnota nesmí obsahovat znak }.

Podmínky

Text
{{#if plan}}
Thanks for being on the {{plan}} plan.
{{else}}
You're on the free plan. Upgrade anytime from your dashboard.
{{/if}}
  • {{else}} je volitelné.
  • Podmínka je nepravdivá, když hodnota chybí, je null, false, 0, prázdný řetězec "" nebo prázdný seznam []. Cokoli jiného je pravdivé, včetně řetězce "0", řetězce "false" a prázdného objektu.
  • Podmínkou je jediná cesta k proměnné, například plan nebo user.is_admin. Neexistuje ==, and, or, not ani unless. Pokud chcete větvit podle hodnoty, vypočítejte ve svém kódu logickou hodnotu a předejte ji, například "is_pro": true.
  • {{else}} a {{/if}} pište přesně tak, jak je uvedeno, bez mezer uvnitř závorek.
  • Temple nejdřív zpracuje podmínky a pak proměnné.

Bloky lze vnořovat. Temple vyhodnocuje nejdřív nejvnitřnější bloky, takže každé {{else}} a {{/if}} patří ke svému vlastnímu {{#if}}:

Text
{{#if plan}}
  {{#if annual}}Billed yearly.{{else}}Billed monthly.{{/if}}
{{else}}
  You're on the free plan.
{{/if}}

Vnořovat lze až do hloubky 10 úrovní.

Escapování a speciální znaky

Hodnoty se pro HTML neescapují. Temple vkládá hodnoty přesně tak, jak je předáte. Hodnota jako Tom & Jerry nebo <b>Ada</b> se do HTML vloží beze změny, proto text od uživatelů escapujte ve svém kódu, než ho předáte. Stejné proměnné plní předmět, HTML i text, takže escapovaná hodnota jako Tom &amp; Jerry se tak zobrazí i v předmětu a textu. Pokud na tom záleží, předejte pro HTML samostatnou escapovanou proměnnou.

Znamená to také, že můžete jako jednu proměnnou předat hotové HTML, například tabulku položek objednávky, kterou vykreslí váš kód.

Pro dvojité složené závorky neexistuje escapovací syntaxe. Temple považuje cokoli mezi {{ a }} za proměnnou, a pokud pro ni nemá hodnotu, odstraní ji. Jednoduchých závorek, například v CSS, se to netýká. Hodnoty se vkládají jednou a znovu se nezpracovávají, takže pokud chcete zobrazit doslovné dvojité závorky, vložte je do proměnné:

JSON
{
  "html": "<p>Write {{example}} in your template to show the first name.</p>",
  "variables": { "example": "{{first_name}}" }
}

Kde Temple běží

Kde Běží Temple? Co můžete použít
E-mailové API s template Vždy variables, které předáte, a global
E-mailové API s vloženým subject, html nebo text Když variables obsahuje alespoň jeden klíč, nebo když obsah používá {{global.…}} variables, které předáte, a global
Automatizace, krok Send email Při každém odeslání Pole kontaktu, tags, score, contact, global, unsubscribe_url, manage_subscriptions_url, payload, meta, run, automation a step, v automatizacích typu Email navíc email. Viz E-maily z automatizací.
Kampaně, jejich testovací e-maily a Preview as contact Vždy Pole kontaktu, cf, custom_fields, tags, score, global, unsubscribe_url, manage_subscriptions_url, webview_url a contact. Viz Kampaně.
SMTP relay Ne Nic. Zpráva se odešle tak, jak jste ji sestavili.
Editory ve webovém rozhraní a jejich náhledy Ne Editory vkládají proměnné a jejich náhledy je zobrazují nevykreslené. Editory MJML (alfaverze) navíc zobrazují náhled Temple s ukázkovými daty. Pokud chcete vidět kampaň vykreslenou pro jeden kontakt, použijte Preview as contact.

E-maily z API

Předejte alias šablony nebo ID tem_ a objekt variables. Pole, která pošlete v požadavku (subject, html, text), nahradí pole šablony a pak Temple vykreslí předmět, HTML a text.

JSON
{
  "from": "Acme <hello@acme.com>",
  "to": "ada@example.com",
  "template": "welcome-email",
  "variables": {
    "first_name": "Ada",
    "plan": "Pro",
    "activation_url": "https://acme.com/activate?token=8f3k2",
    "cf": { "company": "Analytical Engines Ltd" }
  }
}

Editory ve webovém rozhraní vkládají pro vlastní pole kontaktů {{cf.<key>}}. Při odesílání přes API se z vašich kontaktů nic nedohledává, takže tyto hodnoty předejte sami pod cf, jako v příkladu. Totéž platí pro {{unsubscribe_url}}: pokud ho šablona používá, předejte vlastní odkaz pro odhlášení. Výjimkou jsou globální hodnoty: {{global.<key>}} se vyplní z workspace, pokud vaše variables nemají vlastní klíč global.

Můžete také poslat vložený obsah s variables a bez šablony. Viz Odeslání e-mailu.

E-maily z automatizací

Krok Send email při každém odeslání vykreslí předmět, HTML a text jazykem Temple, ať pocházejí ze šablony, nebo z přepsání v kroku.

Automatizace kontaktů dávají pole kontaktu na nejvyšší úroveň, takže funguje:

  • {{email}}, {{first_name}} a {{last_name}}
  • {{cf.<key>}} nebo {{custom_fields.<key>}} pro vlastní pole, například {{cf.plan}}. {{cf.<key>}} je zápis, který používají kampaně a editory.
  • {{tags}}, štítky kontaktu ve tvaru vip, customer, a {{#if tags}}…{{/if}}; {{score}}, skóre kontaktu
  • {{unsubscribe_url}}, odkaz kontaktu pro odhlášení, který se u marketingových e-mailů posílá také v hlavičkách List-Unsubscribe pro odhlášení jedním kliknutím, a {{manage_subscriptions_url}}, odkaz kontaktu na stránku pro správu odběrů
  • {{contact.*}}, tentýž kontakt jako objekt, například {{contact.first_name}}

Všechny automatizace navíc dostávají {{global.*}}, globální hodnoty workspace, {{payload.*}}, data události, která spuštění vyvolala, a {{meta.*}}, metadata spuštění. Dostávají také {{run.id}}, {{automation.id}}, {{automation.name}} a {{step.key}}, klíč kroku Send email. Automatizace typu Email přidávají {{email.*}}, e-mail, který spuštění zahájil, například {{email.mail_from}}. Automatizace typu Email a event nemají kontakt na nejvyšší úrovni, takže použijte {{payload.*}}, nebo příjemce a předmět nastavte v kroku.

Kampaně

Kampaně vykreslují předmět, HTML a text jazykem Temple pro každého příjemce, bez ohledu na to, ve kterém editoru vznikly. Testovací e-maily a Preview as contact se vykreslují stejně. Proměnné pocházejí z kontaktu příjemce:

  • {{first_name}}, {{last_name}} a {{email}}
  • {{unsubscribe_url}}, odkaz příjemce pro odhlášení, a {{manage_subscriptions_url}}, jeho odkaz na stránku pro správu odběrů
  • {{cf.<key>}} nebo {{custom_fields.<key>}} pro vlastní pole, například {{cf.plan}}
  • {{tags}}, štítky kontaktu ve tvaru vip, customer, a {{score}}, skóre kontaktu
  • {{global.<key>}}, globální hodnota, například {{global.offer_url}}
  • {{contact.*}}, stejná pole jako objekt, například {{contact.first_name}}

Prázdná pole kontaktu se počítají jako chybějící, takže se použijí výchozí hodnoty: {{first_name|"there"}} vykreslí u kontaktu bez křestního jména there. Testovací e-maily na adresu, která patří kontaktu ve workspace, použijí data tohoto kontaktu. U ostatních adres se {{email}} vyplní testovací adresou a jména a vlastní pole zůstanou prázdná.

Slučovací značky kampaní napsané předtím, než kampaně začaly používat Temple, fungují dál. Názvy first_name, last_name, email a unsubscribe_url a předpona cf. se shodují bez ohledu na velikost písmen, takže {{FIRST_NAME}} stále funguje. Klíče vlastních polí musí odpovídat přesně. Viz Slučovací značky.

SMTP

SMTP relay přijímá hotovou zprávu. Žádná šablona se nedohledává a Temple se nespouští, takže finální HTML sestavte před odesláním, nebo použijte API či automatizaci, pokud potřebujete proměnné.

Zkontrolujte šablony před publikováním

Emailit kvůli chybné syntaxi Temple neodmítne šablonu ani odeslání. Chyby se obvykle projeví jako chybějící text nebo zbylé závorky v doručeném e-mailu. Výjimkou jsou šablony MJML (alfaverze): při jejich uložení se Temple zkontroluje a nespárované bloky se odmítnou. Před publikováním:

  • Zkontrolujte, že každé {{#if …}} má odpovídající {{/if}} a každé {{ uzavírací }}.
  • Pošlete si koncept verze podle jeho ID tem_ s realistickými variables, včetně chybějících a prázdných hodnot, abyste viděli obě větve každé podmínky. Viz Verze šablon.
  • U kampaně použijte Preview as contact s kontakty, které jednotlivé hodnoty mají, i s těmi, které je nemají, a pak si pošlete testovací e-mail. Viz Testování a naplánování kampaně.

Příklady

Pozdrav s náhradní hodnotou:

Text
Hi {{first_name|"there"}},

Blok, který závisí na tarifu:

Text
{{#if plan}}
Your plan: {{plan}}
{{else}}
Upgrade anytime from your dashboard.
{{/if}}

Předmět s vnořenou hodnotou:

Text
Order {{order.number}} has shipped, {{user.first_name|"friend"}}

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.