HTML blocks
A HTML block is one of the many block types that you can use in a responsive email. It is a very popular one and it is easy to use: it is just a piece of text, with simple HTML formatting.
{
"from" : "info@example.com",
"subject" : "Email with only one text block",
"content" : {
"blocks" : [ {
"type" : "html",
"content" : "Example <b>HTML</b> code"
} ]
}
}
The example above demonstrates how to include a HTML block in your email.
As you can see, you can use simple markup tags like <p>
, <b>
, <i>
, <a>
, etc.
We recommend to not really go beyond these tags, because it might cause
compatibility issues across different email clients.
Inside the block you can use sub properties. The most obvious ones were
already demonstrated in the example, content
and type
, but there are
many more. The following tables lists all supported properties.
HTML block properties
Property | Value | Description |
---|---|---|
type | "html" | Identifies the block as a HTML block. |
content | string | The textual content of the block. This may include HTML. |
url | string | A url to fetch the html content from. |
font | object | Override the template wide default font properties. |
background | object | The background of the text block. |
margin | mixed | Margins around the text. |
padding | mixed | Whitespace around the block, this whitespace will have a background |
visibility | object | Visibility based on device, client and/or receiver. |
rewrite | object | Rewrite rules for urls. |
container | object | Access to the surrounding container |
Example
The following JSON input shows a more extensive example how to use all the properties of a HTML block.
{
"from" : "info@example.com",
"subject" : "Email with only one HTML block",
"content" : {
"blocks" : [ {
"type" : "html",
"content" : "Example <b>HTML</b> code",
"font" : {
"family" : "verdana,arial,helvetica",
"size" : "14px",
"color" : "black"
},
"background" : {
"color" : "#eee"
},
"margin" : {
"top" : 10,
"bottom" : 20
},
"container" : {
"css" : {
"border": "solid 1px red"
}
}
} ]
}
}
Found a typo?
You can find this documentation page on GitHub.
Propose a change