Loop Syntax

Loop tags allow you to dynamically repeat content in your documents. You can use them to repeat paragraphs, table rows, table columns, and list items based on your data.

To get started, follow the examples below.

Simple example

To repeat content, simply wrap it with a loop tag. The content can include constant parts as well as other tags to be replaced with data:

Provide an array in your data to populate the loop:

{
    "HealthyFood": [
        { "FruitName": "Apple" },
        { "FruitName": "Banana" },
        { "FruitName": "Orange" }
    ]
}

The resulting document will contain the list of fruits:

List items

Repeating list items is a common use case. Place the loop tag inside a list item, and the service will automatically generate a new list item for each element in your data array:

Consider the following data:

{
  "Pets": [
    { "Name": "Max", "Type": "Dog" },
    { "Name": "Jack", "Type": "Parrot" },
    { "Name": "Wendy", "Type": "Cat" }
  ]
}

The resulting document will contain the list of pets:

The same approach works for numbered lists:

And the resulting document will contain the list of pets:

Table rows

To repeat table rows, place the opening tag at the beginning of the row and the closing tag in the last cell. The service will create a new row for each item in your data array:

We'll use the same data as in the previous example:

{
  "Pets": [
    { "Name": "Max", "Type": "Dog" },
    { "Name": "Jack", "Type": "Parrot" },
    { "Name": "Wendy", "Type": "Cat" }
  ]
}

And the resulting document will now be:

Table columns

You can also repeat table columns. Place the opening tag in the first cell of the column and the closing tag in the last cell. The service will create a new column for each item in your data array:

Consider the following data:

{
    Students: [
        {
            Name: "John Doe",
            Math: "A",
            Science: "B+",
            History: "A-",
        },
        {
            Name: "Jane Smith",
            Math: "B",
            Science: "A",
            History: "A",
        },
    ],
}

The resulting document will show the student's grades across subjects: