Skip to main content
Expressions may be configured in your project’s config.js:
config.js
export default {
  expressions: {
    // ...
  }
}

​
delimiters

​
delimiters
array
default:"['{{', '}}']"
Array containing beginning and ending delimiters for expressions.It’s common for templating engines (like those used by email service providers) to use {{ and }} as delimiters. You may change the ones Maizzle uses in order to avoid conflicts:
config.js
export default {
  expressions: {
    delimiters: ['[[', ']]'],
  }
}

​
unescapeDelimiters

​
unescapeDelimiters
array
default:"['{{{', '}}}']"
Array containing beginning and ending delimiters for unescaped locals.You’d normally use these when you want to output HTML from a variable without escaping it:
{{ '<span>escaped</span>' }}
{{{ '<span>unescaped</span>' }}}
Result:
&lt;span&gt;escaped&lt;/span&gt;
<span>unescaped</span>

​
locals

​
locals
object
default:"{}"
Variables defined here will be available ‘locally’, meaning you won’t need to use the page object when accessing them.For example, if you set this to something like {foo: 'bar'}, you can access it in your templates through {{ foo }} instead of {{ page.foo }}.

​
localsAttr

​
localsAttr
string
default:"locals"
Attribute name for <script> tags that contain locals.Imagine you’d write <script vars> instead of <script locals> to define variables in your templates. You can change the attribute name like this:
config.js
export default {
  expressions: {
    localsAttr: 'vars',
  }
}
Then, you’d use it like this:
example.html
<script vars>
  module.exports = {
    foo: "bar"
  }
</script>

{{ foo }}

​
removeScriptLocals

​
removeScriptLocals
boolean
default:"false"
Whether to remove <script> tags that contain locals.

​
conditionalTags

​
conditionalTags
array
default:"['if', 'elseif', 'else']"
Array containing tag names to be used for if/else statements.

​
switchTags

​
switchTags
array
default:"['switch', 'case', 'default']"
Array containing tag names to be used for switch statements.

​
loopTags

​
loopTags
array
default:"['each', 'for']"
Array containing tag names to be used for loops.

​
scopeTags

​
scopeTags
array
default:"['scope']"
Array containing tag names to be used for scopes.

​
ignoredTag

​
ignoredTag
string
default:"raw"
Name of tag inside of which expression parsing is disabled.Besides {{ }} expressions, the following tags will be ignored and output as-is:
  • conditional tags (if/elseif/else)
  • switch tags (switch/case/default)
  • loop tags (each/for)
  • scope tags (scope)

​
strictMode

​
strictMode
boolean
default:"false"
Maizzle disables strictMode so that if you have an error inside an expression, it will be rendered as undefined and the email will still be compiled, instead of the build failing.

​
missingLocal

​
missingLocal
undefined | string
default:"{local}"
Define what to render when referencing a value that is not defined in locals.
missingLocalstrictModeOutput
undefinedtrueError is thrown
undefinedfalseundefined (string)
''false/true'' (empty string)
{local}false/trueOriginal reference like {{ foo }}
By default, Maizzle will output the string the original reference as a string, i.e. {{ foo }}, when a value is not defined.

Build docs developers (and LLMs) love

Get started for freeTalk to us