Text blocks

A text block is one of the many block types that you can use in a responsive email. It is a very popular one (we do not often see mails without text), and it is easy to use: it is just a piece of text.

    {
        "from" : "info@example.com",
        "subject" : "Email with only one text block",
        "content" : {
            "blocks" : [ {
                "type" : "text",
                "content" : "Example textual content"
            } ]
        }
    }

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.

Please keep in mind that you can only use pure text in text blocks. If you want some sort of formatting, you can use a HTML block instead.

Text block properties

Property Value Description
type "text" Identifies the block as a text block.
content string The textual content of the block. This may include HTML.
url string A url to fetch the textual 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.
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 text block.

{
    "from" : "info@example.com",
    "subject" : "Email with only one text block",
    "content" : {
        "blocks" : [ {
            "type" : "text",
            "content" : "Example text",
            "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