1. i.e. The first value in an array named items is items[1].| Name | \nPrice | \n
|---|---|
| {{loop_var.name}} | \n${{loop_var.price}} | \n
| Name | \nPrice | \n
|---|---|
| Jacket | \n$39.99 | \n
| Gloves | \n$5 | \n
Insert a chunk of html:
\n{{ render_dynamic_content(dynamic_html.my_html_chunk) }}\n\n```\n\n```json\n{\n \"dynamic_html\": {\n \"my_html_chunk\" : \"\"\n },\n \"username\" : \"foo\"\n}\n```\n\n```results\n\nInsert a chunk of html:
\n\n\n```\n\nToday's special offers
Today's special offers
Our body content
\n{{ render_snippet( \"ourfooter\" ) }}\n\n```\n\nThe resulting rendered HTML email content would look like:\n\n```\n\nOur body content
\n\n\n```\n\nThe `render_snippet` macro takes a snippet ID as its only argument, which may come from `substitution_data`.\nThe following example illustrates how one of two plain text snippets can be utilized, based on the recipient's `substitution_data`.\n\nTwo snippets are created:\n\n```\n{\n \"id\" : \"banner_snippet_A\",\n \"content\" : {\n \"text\" : \"Banner A\"\n }\n}\n```\n\n```\n{\n \"id\" : \"banner_snippet_B\",\n \"content\" : {\n \"text\" : \"Banner B\"\n }\n}\n```\n\nTransmission with content.text:\n\n```\nThe following banner depends on the \"banner_id\" substitution_data value\n{{ render_snippet( banner_id ) }}\n```\n\nWhere Recipient 1 has substitution_data:\n\n```\n{\n \"banner_id\" : \"banner_snippet_A\"\n}\n```\n\nAnd Recipient 2 has substitution_data:\n\n```\n{\n \"banner_id\" : \"banner_snippet_B\"\n}\n```\n\nOther notes on snippet usage:\n\n- Snippets themselves may contain substitution syntax. Though some restrictions apply: snippets cannot reference other snippets (`render_snippet`), nor can they utilize `render_dynamic_content`.\n\n- Snippets may contain links (which will be click tracked if `click_tracking` is enabled).\n\n- If a `render_snippet` call references a snippet which does not exist, the transmission will be discarded with a generation failure event.\n\n- A template may utilize `render_snippet` at most 5 times. If this limit is exceeded, the transmission will be discarded with a generation failure event.\n\n- Snippet UI can take up to 2 minutes to reflect the changes made.\n\n## Advanced\n\n### Substitutions in email_rfc822 Headers\n\nWhen it is desirable to have substitutions in RFC2047 encoded headers which are folded, be sure that each line of the header is separately RFC2047 encoded. Otherwise, the server will not be able to decode the header to look for the template language syntax.\n\n**Correct:**\n\n```\nSubject: =?gb2312?B?ztLE3M3Mz8Kyo8Gntviyu8nLye3M5c7SxNzNzM/CsqPBp7b4srvJy8ntzOU=?=\n =?gb2312?B?ztLE3M3Mz8Kyo8Gntvg=?= \n```\n\n**Incorrect:**\n\n```\nSubject: =?gb2312?B?ztLE3M3Mz8Kyo8Gntviyu8nLye3M5c7SxNzNzM/CsqPBp7b4srvJy8ntzOU=\n ztLE3M3Mz8Kyo8Gntvg=?=\n```\n\n### Encoding Rules\n\n- If after substitution, a text/plain, text/html, or text/x-amp-html part contains 8-bit data, then that part will be quoted-printable encoded before being placed back into the MIME structure. The Content-Type will be updated appropriately.\n\n- If after substitution, a header value contains 8-bit data, then the header\n value will be RFC2047 base64 encoded before being written back to the headers structure."}]}]},"TableOfContents":[{"anchor":"#header-template-variables","title":"Template Variables","children":[{"anchor":"#header-sources","title":"Sources"},{"anchor":"#header-reserved-variables","title":"Reserved Variables"}]},{"anchor":"#header-expressions","title":"Expressions","children":[{"anchor":"#header-missing-variables","title":"Missing Variables"},{"anchor":"#header-default-values","title":"Default Values"},{"anchor":"#header-nested-object-paths","title":"Nested Object Paths"},{"anchor":"#header-html-escaping","title":"HTML Escaping"}]},{"anchor":"#header-statements","title":"Statements","children":[{"anchor":"#header-if-else-statement","title":"if/else Statement","children":[{"anchor":"#header-relational-and-logical-operators","title":"Relational and Logical Operators"},{"anchor":"#header-arithmetic-operators","title":"Arithmetic Operators"}]},{"anchor":"#header-each-statement","title":"each Statement","children":[{"anchor":"#header-nested-loops","title":"Nested Loops"},{"anchor":"#header-array-indexing","title":"Array Indexing"}]}]},{"anchor":"#header-links","title":"Links","children":[{"anchor":"#header-links-in-variables","title":"Links in Variables"},{"anchor":"#header-links-in-loops-and-conditionals","title":"Links in Loops and Conditionals"},{"anchor":"#header-personalized-links","title":"Personalized Links"},{"anchor":"#header-url-encoding","title":"URL Encoding"},{"anchor":"#header-custom-link-attributes","title":"Custom Link Attributes","children":[{"anchor":"#header-link-names","title":"Link Names"},{"anchor":"#header-unsubscribe-links","title":"Unsubscribe Links"},{"anchor":"#header-per-link-disabling-of-click-tracking","title":"Per-link Disabling of Click Tracking"},{"anchor":"#header-custom-link-sub-paths","title":"Custom Link Sub-Paths"}]}]},{"anchor":"#header-macros","title":"Macros","children":[{"anchor":"#header-render_dynamic_content()","title":"render_dynamic_content()"},{"anchor":"#header-empty()","title":"empty()"},{"anchor":"#header-render_snippet()","title":"render_snippet()"},{"anchor":"#header-braces-macros","title":"Braces Macros"},{"anchor":"#header-escaping-curly-braces-in-amp-mustache-templates","title":"Escaping curly braces in amp-mustache templates"}]},{"anchor":"#header-dynamic-content","title":"Dynamic Content"},{"anchor":"#header-snippets","title":"Snippets"},{"anchor":"#header-advanced","title":"Advanced","children":[{"anchor":"#header-substitutions-in-email_rfc822-headers","title":"Substitutions in email_rfc822 Headers"},{"anchor":"#header-encoding-rules","title":"Encoding Rules"}]}],"meta":{"title":"Template Language","description":"Documentation for the template language and substitution capabilities of SparkPost.","full":true},"fields":{"path":"/api/template-language/"}}},"pageContext":{"file":"template-language.apib"}},"staticQueryHashes":["1319884646","1428769721","3859448388"]}