Template tags reference

Box Doc Gen template tags currently support English only. Test your templates to verify they meet your language requirements before production use.

Template tags let you create document templates that automatically fill in with data. When you generate a document, Box Doc Gen finds the tags in your template, matches them to fields in your JSON input, and replaces each tag with the corresponding value.

1. Text tags

A text tag is any data field of type, string, number, or date. In the example below, you can turn id, date, customerId, customerName, currency, amount into text tags.

{
  "invoice":{
    "id": "Inv1203",
    "date": "13-03-2023",
    "customerId": "90158",
    "customerName": "Acme Inc",
    "currency": "$",
    "amount": 5060.50
  }
}

In the output document generated, all the template tags will be replaced with the input data.

Box Doc Gen tags do not support spaces or hyphens between key words in the tag. For example, **{{first name}}** or **{{first-name}}** are not supported.

Document template	Output document
Invoice Invoice id: `{{invoice.id}}` Invoice date: `{{invoice.date}}` Customer details: Customer id: `{{invoice.customerId}}` Customer name: `{{invoice.customerName}}` Amount Payable: `{{invoice.currency}}{{invoice.amount}}`	Invoice Invoice id: Inv1203 Invoice date: 13-03-2023 Customer details: Customer id: 90158 Customer name: Acme Inc Amount Payable: $5060.50

Optional tags

Input format	Input data	Output data
`{{invoice.customerName}}`	-	{{invoice.customerName}}
`{{invoice.customerName :: optional}}`	-

Default values

Input format	Input data	Output data
`{{invoice.customerName}}`	-	{{invoice.customerName}}
`{{invoice.customerName :: default(“Box Inc”)}}`	-	Box Inc

Formatting text tags

Input format	Input data	Output data	Supported via script	Supported via Add-in
`{{invoice.customerName :: uppercase}}`	Acme Inc	ACME INC	Yes	No
`{{invoice.customerName :: lowercase}}`	Acme Inc	acme inc	Yes	No
`{{invoice.date :: format(` `“dd-mm-yyyy”) }}`	13-03-2023	13-03-2023	Yes	No
`{{invoice.date :: format(“mm-dd-yyyy”) }}`	13-03-2023	03-13-2023	Yes	No
`{{invoice.date :: format(“dd-mmm-yy”) }}`	13-03-2023	13-Mar-22	Yes	No
`{{invoice.id :: format(“xxx-xxxx”) }}`	Inv1203	Inv-1203	Yes	No
`{{invoice.amount :: format(“EU-Number”) }}`	300000	300.000	Yes	No
`{{invoice.amount :: format(“US-Number”) }}`	300000	300,000	Yes	No

Rich text

Box Doc Gen enables you to generate documents with rich text. If the input JSON data contains HTML tags such as bold, italic, underline, line breaks, paragraphs, anchors, images, or tables, Doc Gen automatically interprets them as rich text and applies the relevant formatting.

HTML Tags JSON data Output

Bold { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Italic { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Underline { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Bold, Italic and Underline { “company”: “Acme Inc.A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Strong { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Span { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Emphasized { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999

Line breaks { “company”: “Acme Inc. \n A fictional company that features prominently in the Road Runner show as a running gag. \n Phone: 999-999-9999” } Acme Inc.
A fictional company that features prominently in the Road Runner show as a running gag.
Phone: 999-999-9999

Paragraphs { “company”: “Acme Inc. A fictional company that features prominently in the Road Runner show as a running gag. Phone: 999-999-9999” } Acme Inc.
A fictional company that features prominently in the Road Runner show as a running gag.
Phone: 999-999-9999

Ordered list

<ol><li>Blue</li><li>Green</li><li>Red</li></ol>

Blue
Green
Red

Unordered list

<ul><li>Blue</li><li>Green</li><li>Red</li></ul>

Blue
Green
Red

Table

{ “invoice”: { “summary”: “<table><tr><td>Name</td><td>Qty</td></tr><tr><td>A4 Papers</td><td>100</td></tr><tr><td>Ink cartridge</td><td>40</td></tr><tr><td>Adhesive tape</td><td>20</td></tr></table>” } }

Name	Quantity
A4 Papers	100
Ink cartridge	40
Adhesive tape	20

2. Image tags

Doc Gen enables you to embed any image file in Box into the generated document. To do this, you will need to follow the following steps:

1. Upload the image file to Box

The image file being used for document generation has to be uploaded to Box. Generating documents via API If you are using a service account to generate the document via APIs, ensure the service account has access to the file.

2. Author the Doc Gen template

Doc Gen enables you to generate documents using images in the following ways:

Generating documents from a placeholder image
Generating documents with HTML images

Generating documents from a placeholder image

Authoring a Doc Gen template using Add-in for Microsoft Word To insert an Image tag using the add-in:

In the Box Doc Gen Template Creator add-in, create an image tag using your desired placeholder image
Navigate to the Document Tags > Image Tags.
In the document, select the area to insert an Image tag.
Double-click the image tag to insert it.

The result is a placeholder image, which can be dynamically replaced by the input data from the Box Doc Gen API, or any other upstream systems.

Gray placeholder image with a circle and two mountain shapes.

The dimensions, and alignments of the placeholder image can be altered using Microsoft Word functions. These properties are retained in the output document. The placeholder image has the following code added to the image under “Alt Text”. To view it, select the image, right-click, and then select View Alt Text.

{
  "image-path": "singleImage",
  "alt-text": ""
}

The image-path - is the key field for the Image from the JSON Payload used to make a request to Generate a document.
You can also add a placeholder image by simply dragging and dropping it into the document or inserting an image placeholder. However, make sure to manually include the required code in the ALT TEXT field.

Repeating images within a for-loop: To generate a document with multiple images in a for-loop, ensure the image is wrapped in a For function as below,

{{ for item in multipleImages }}

{
  "image-path": "{{ item.id }}",
  "alt-text": ""
}

{{ endfor }}

Repeating images within a table-loop: To generate a document with multiple images in a table-loop, ensure the image is wrapped in a Table function as below,

`{{ tablerow item in multipleImages }}`
`{{ item.name }}`	Embedded image whose Alt Text includes JSON with `image-path`
`{{ endtablerow }}`

Ensure to include the image path in the ALT TEXT section of the image

{
  "image-path": "singleImage",
  "alt-text": ""
}

Generating documents with HTML images

To generate a document with an HTML image from the JSON payload, include a text tag in the template.

For example: {{htmlImage}}

This method only supports generation of simple images, and does not support generation of repeating images in For-loops and Table-loops.

3. Create the JSON payload to generate the document

Generating documents from a placeholder image

To generate a document with an image file in Box, use the following schema:

Key used in the Placeholder image (Ex: singleImage)
id - to pass the file id of the Image file in Box
type - to signify that this is an image file to be embedded in the document

{
  "singleImage": {
    "id": "1948600448426",
    "type": "image",
    "name": "Title for image 1"
  }
}

The image file id mentioned here should refer to your file id in Box.

{
  "image-path": "singleImage",
  "alt-text": ""
}

Generating a document from a Placeholder with multiple images To generate a document with multiple image files in Box, run an array of image schema as shown below,

{
  "multipleImages": [
    {
      "id": "1948600448426",
      "type": "image",
      "name": "Title for image 2"
    },
    {
      "id": "1948600448427",
      "type": "image",
      "name": "Title for image 3"
    },
    {
      "id": "1948600448428",
      "type": "image",
      "name": "Title for image 4"
    }
  ]
}

Generating documents with HTML images

To include an image from Box in your document using an HTML image tag, define the JSON schema in the following format:

{
  "htmlImage": "<img src='file://[FILE_ID]' alt='Sample product image' height='500' width='500'/>"
}

In this example:

file://[FILE_ID] refers to the file ID of the image stored in Box
height and width define the display size of the image
alt specifies the alternative text for the image

4. Make a document generation request

Doc Gen enables you to create documents with embedded images sourced directly from Box. You can include images in your generated documents using one of the following methods:

Box Doc Gen API – Generate documents with images programmatically. Refer to the Box Doc Gen API documentation for step-by-step guidance.
Box Doc Gen Web App – Create documents with embedded images through the web interface. See the documentation for detailed instructions.

Salesforce Integration – Generate documents with images by referencing a Box file ID. Ensure the required JSON schema pattern is followed. For setup and usage, refer to the Salesforce integration documentation.

3. Table tags

An array from the input data can be used to generate and dynamically format a table. In the following example:

items is an array that can be rendered as a dynamic table.
id, name, quantity, price, amount are the variables within the array that can be rendered as individual columns to the dynamic table.

{
  "invoice":{
    "number": "Inv1203",
    "date": "13-03-2023",
    "customerId": "90158",
    "currency": "$",
    "amount": 5060.50,
    "items": [
      {
        "id": 1,
        "name": "A4 Papers",
        "quantity": 100,
        "price": 29,
        "amount": 2900
      },
      {
        "id": 2,
        "name": "Ink  Cartridge",
        "quantity": 40,
        "price": 39,
        "amount": 1560
      },
      {
        "id": 3,
        "name": "Adhesive tape",
        "quantity": 20,
        "price": 30,
        "amount": 600.50
      }
    ]
  }
}

Document Template

The document template with inserted tags will look as follows:

Id	Name	Qty	Price
`{{tablerow item in invoice.items}}`
`{{item.id}}`	`{{item.name}}`	`{{item.quantity}}`	`{{item.price}}`
`{{endtablerow}}`

Output

Box Doc Gen automatically identifies the table tags added to the document template, matches them with the fields in the input JSON data, and performs a few iterations to generate a complete table for the input data. The output table on the generated document will look as follows:

Id	Name	Qty	Price
1	A4 Papers	100	29
2	Ink Cartridge	40	39
3	Adhesive tape	20	30

4. Nested tables

Nested tables let you generate a dynamic table inside another dynamic table using related nested JSON arrays. Key points:

tablerow … endtablerow repeats table rows. One item becomes one row.
for … endfor repeats text in place. Use it inside a cell, or around a whole table.
expenses[0] is the first expense. Counting starts at 0, so the second expense is expenses[1].

The sample data has four levels:

Event: name, date, and currency
Expenses: Food & Supplies in Amsterdam, and Furniture in London
Category items: the line items of each expense, such as Apples and Chairs
Extra items: trays, cartons, packets, and boxes for each line item

The following JSON serves as input for the nested table examples:

Sample JSON for nested tables

{
  "eventName": "Developer Conference",
  "currency": "$",
  "eventDate": "2026-05-12",
  "expenses": [
    {
      "categoryName": "Food & Supplies",
      "categoryValue": 50,
      "city": "Amsterdam",
      "categoryItems": [
        {
          "itemName": "Apples",
          "itemQty": 60,
          "itemValue": 30,
          "extraItems": [
            { "itemName": "Trays", "itemValue": 5 },
            { "itemName": "Cartons", "itemValue": 3 }
          ]
        },
        {
          "itemName": "Napkins",
          "itemQty": 200,
          "itemValue": 20,
          "extraItems": [
            { "itemName": "Packets", "itemValue": 2 }
          ]
        }
      ]
    },
    {
      "categoryName": "Furniture",
      "categoryValue": 2000,
      "city": "London",
      "categoryItems": [
        {
          "itemName": "Chairs",
          "itemQty": 40,
          "itemValue": 800,
          "extraItems": [
            { "itemName": "Boxes", "itemValue": 15 }
          ]
        },
        {
          "itemName": "Tables",
          "itemQty": 10,
          "itemValue": 1200,
          "extraItems": [
            { "itemName": "Boxes", "itemValue": 20 }
          ]
        }
      ]
    }
  ]
}

Example 1: List the items inside the category row

The table has one row per expense. The last cell lists the items of that expense, one field per line, so the items stay stacked in that cell.

`{{ tablerow x in expenses }}`
`{{x.categoryName}}`	`{{x.categoryValue}}`	`{{x.city}}`	`{{ for y in x.categoryItems }}` `{{y.itemName}}` `{{y.itemValue}}` `{{ endfor }}`
`{{ endtablerow }}`

Output

Category	Value	City	Items
Food & Supplies	50	Amsterdam	Apples 30 Napkins 20
Furniture	2000	London	Chairs 800 Tables 1200

Example 2: Display only the first expense

The table reads items from expenses[0] only, which is Food & Supplies in Amsterdam. The Furniture expense is left out.

`{{ tablerow a in expenses[0].categoryItems }}`
`{{a.itemName}}`	`{{a.itemQty}}`	`{{a.itemValue}}`
`{{ endtablerow }}`

To print the London items instead, use expenses[1].categoryItems. Output

Item	Qty	Value
Apples	60	30
Napkins	200	20

Example 2.1: Display one row per item for every expense

An inner table loop sits inside an outer table loop. Box Doc Gen prints the Amsterdam items first, then the London items.

`{{ tablerow x in expenses }}`
`{{ tablerow a in x.categoryItems }}`
`{{a.itemName}}`	`{{a.itemQty}}`	`{{a.itemValue}}`
`{{ endtablerow }}`
`{{ endtablerow }}`

Example 2 prints the first expense only. This example prints every expense. Output

Item	Qty	Value
Apples	60	30
Napkins	200	20
Chairs	40	800
Tables	10	1200

Example 3: Add the event name, date, and currency

Rows above the table loops print once. The currency tag sits in the repeating row, so it prints on every item.

`{{eventName}}`
`{{eventDate}}`
`{{ tablerow x in expenses }}`
`{{ tablerow b in x.categoryItems }}`
`{{b.itemName}}`	`{{b.itemQty}}`	`{{currency}} {{b.itemValue}}`
`{{ endtablerow }}`
`{{ endtablerow }}`

Output

Developer Conference
2026-05-12
Apples	60	$ 30
Napkins	200	$ 20
Chairs	40	$ 800
Tables	10	$ 1200

Example 4: Display every category name on each item row

This template produces the same item rows as Example 3, plus a cell that lists every category name with for z in expenses.

`{{eventName}}`
`{{eventDate}}`
`{{ tablerow x in expenses }}`
`{{ tablerow c in x.categoryItems }}`
`{{c.itemName}}`	`{{c.itemQty}}`	`{{currency}} {{c.itemValue}}`	`{{ for z in expenses }}` • `{{z.categoryName}}` `{{ endfor }}`
`{{ endtablerow }}`
`{{ endtablerow }}`

The loop reads the full expenses list, so both category names appear on every row. The event name and date still print once above these rows. Output

Developer Conference
2026-05-12
Apples	60	$ 30	• Food & Supplies • Furniture
Napkins	200	$ 20	• Food & Supplies • Furniture
Chairs	40	$ 800	• Food & Supplies • Furniture
Tables	10	$ 1200	• Food & Supplies • Furniture

Example 5: Add extra items for each line item

The extraItems array sits inside the line item. The loop in the last cell prints the extra items for that row only.

`{{eventName}}`
`{{eventDate}}`
`{{ tablerow x in expenses }}`
`{{ tablerow d in x.categoryItems }}`
`{{d.itemName}}`	`{{d.itemQty}}`	`{{currency}} {{d.itemValue}}`	`{{ for w in d.extraItems }}` `{{w.itemName}} {{w.itemValue}}` `{{ endfor }}`
`{{ endtablerow }}`
`{{ endtablerow }}`

Output

Developer Conference
2026-05-12
Apples	60	$ 30	Trays 5 Cartons 3
Napkins	200	$ 20	Packets 2
Chairs	40	$ 800	Boxes 15
Tables	10	$ 1200	Boxes 20

Example 6: Create one table per expense

The for loop sits outside the table. Box Doc Gen repeats the whole table once per expense, so the output has two tables. {{ for x in expenses }}

`{{ tablerow e in x.categoryItems }}`
`{{e.itemName}}`	`{{e.itemQty}}`	`{{e.itemValue}}`
`{{ endtablerow }}`

{{ endfor }} Output

Item	Qty	Value
Apples	60	30
Napkins	200	20

Item	Qty	Value
Chairs	40	800
Tables	10	1200

These tables have no heading of their own. To label each one, add {{x.categoryName}} inside the for loop, on the line above the table.

An array from the input data can be used to dynamically generate an ordered or unordered list. In the following example:

items is an array that can be rendered as a dynamic list.
id, name, quantity, price, amount are the variables within the array that can be rendered as a repetitive field in the list.

{
  "invoice":{
    "number": "Inv1203",
    "date": "13-03-2023",
    "customerId": "90158",
    "currency": "$",
    "amount": 5060.50,
    "items": [
      {
        "id": 1,
        "name": "A4 Papers",
        "quantity": 100,
        "price": 29,
        "amount": 2900
      },
      {
        "id": 2,
        "name": "Ink  cartridge",
        "quantity": 40,
        "price": 39,
        "amount": 1560
      },
      {
        "id": 3,
        "name": "Adhesive tape",
        "quantity": 20,
        "price": 30,
        "amount": 600.50
      }
    ]
  }
 }

The input data can be used to generate different types of lists:

Use case	Document template	Output document
Adding a bullet list	List of products: `{{ for item in invoice.items }}` • `{{item.name}}` `{{ endfor }}`	List of products: • A4 Papers • Ink cartridge • Adhesive tape
Adding a bullet list with one or more variables	List of products: `{{ for item in invoice.items }}` • `{{item.name}}, {{item.quantity}}` `{{ endfor }}`	List of products: • A4 Papers, 100 • Ink cartridge, 40 • Adhesive tape, 20
Adding a squared bullet list with one or more variables	List of products: `{{ for item in invoice.items }}` • `{{item.name}}, {{item.quantity}}` `{{ endfor }}`	List of products: • A4 Papers, 100 • Ink cartridge, 40 • Adhesive tape, 20
Adding a white bullet list with one or more variables	List of products: `{{ for item in invoice.items }}` • `{{item.name}}, {{item.quantity}}` `{{ endfor }}`	List of products: • A4 Papers, 100 • Ink cartridge, 40 • Adhesive tape, 20
Adding a numbered list with one or more variables	List of products: `{{ for item in invoice.items }}` 1. `{{item.name}}, {{item.quantity}}` `{{ endfor }}`	List of products: 1. A4 Papers, 100 2. Ink cartridge, 40 3. Adhesive tape, 20
Adding a roman numbered list with one or more variables	List of products: `{{ for item in invoice.items }}` 1. `{{item.name}}, {{item.quantity}}` `{{ endfor }}`	List of products: 1. A4 Papers, 100 2. Ink cartridge, 40 3. Adhesive tape, 20
Adding an alphabetical list with one or more variables	List of products: `{{ for item in invoice.items }}` 1. `{{item.name}}, {{item.quantity}}` `{{ endfor }}`	List of products: 1. A4 Papers, 100 2. Ink cartridge, 40 3. Adhesive tape, 20

Formatting lists

Box Doc Gen templates support a wide range of custom codes that you can use in the document template. Taking the following JSON input data as an example, you can introduce different separators and delimiters.

{
  "items": ["A4 Papers", "Ink  cartridge", "Adhesive tape"]
}

Type of list	Document template	Output document
List - with comma separator	`{{ items :: delimiter(“,”)}}`	A4 Papers, Ink cartridge, Adhesive tape
List - with semicolon separator	`{{ items :: delimiter(“;”)}}`	A4 Papers; Ink cartridge; and Adhesive tape
List - with custom separator	`{{ items :: delimiter(“~”)}}`	A4 Papers~ Ink cartridge~ Adhesive tape
List - with Comma and last delimiter	`{{ items :: delimiter(“,”) , lastdelimiter (“, and”)}}`	A4 Papers, Ink cartridge, and Adhesive tape
List - with semicolon and last delimiter	`{{ items :: delimiter(“;”) , lastdelimiter (“; and”)}}`	A4 Papers; Ink cartridge; and Adhesive tape
List - with custom separator and last delimiter	`{{ items \| delimiter(“”) , lastdelimiter (“ and”)}}`	A4 Papers~ Ink cartridge~ and Adhesive tape

6. Conditions

You can use conditions to add input to the output document. The Box Doc Gen Template Creator add-in can help you define these conditions within the document template.

Supported conditions and operators

Tag type	Conditions supported	Operators supported to chain conditions
String	==(is equal to), !=(is not equal to), isPresent	AND, OR
Date	isPresent	AND, OR
Number	<, >, ==, !=, >=, <=	AND, OR

The following JSON serves as input for defining conditions for the Box Doc Gen template.

{
  "invoice":{
    "number": "Inv1203",
    "date": "13-03-2023",
    "customerId": "90158",
    "currency": "$",
    "amount": 5060.50,
    "paymentMethod": "Cheque",
    "paymentTerms": "Net60",
    "deliveryDate": "23-03-2023",
    "items": [
      {
        "id": 1,
        "name": "A4 Papers",
        "quantity": 100,
        "price": 29,
        "amount": 2900
      },
      {
        "id": 2,
        "name": "Ink cartridge",
        "quantity": 40,
        "price": 39,
        "amount": 1560
      },
      {
        "id": 3,
        "name": "Adhesive tape",
        "quantity": 20,
        "price": 30,
        "amount": 600.50
      }
    ]
  }
 }

Use case	Document template	Output document
Introducing content based on payment method and payment terms	Payment terms: `{{ if invoice.paymentMethod == “Online Transfer” AND invoice.paymentTerms == “Net30” }}` • The invoice must be paid within 30 calendar days of the invoice date. • The payment reference should contain the invoice number as reference. `{{ elseif invoice.paymentMethod == “Cheque” AND invoice.paymentTerms == “Net60” }}` • The invoice must be paid within 60 calendar days of the invoice date. • The payment reference should contain the invoice number as reference. • CHECK MADE PAYABLE TO: Box Inc, 900 Jefferson Ave, Redwood City, CA 94063, United States. `{{else}}` • The invoice must be paid within 7 calendar days of the invoice date. `{{endif}}`	Payment terms: • The invoice must be paid within 60 calendar days of the invoice date. • The payment reference should contain the invoice number as reference. • CHECK MADE PAYABLE TO: Box Inc, 900 Jefferson Ave, Redwood City, CA 94063, United States.
Adding processing fees based on invoice amount, and payment method	Processing fees: `{{ if invoice.amount > 1000 AND invoice.amount < 5000 AND invoice.paymentMethod == “Cheque” }}` • There will be an additional 1% processing fee that will be added to your account. • The processing fee will be included to your next invoice. `{{ elseif invoice.amount > 5000 AND invoice.paymentMethod == “Cheque”}}` • The invoice can be paid via check or online transfer without any added processing fees. `{{else}}` • The invoice must be paid within 7 calendar days of the invoice date. `{{endif}}`	Processing fees: • The invoice can be paid via check or online transfer without any added processing fees.
Adding delivery terms based on delivery date on invoice	Delivery terms: `{{ if invoice.deliveryDate isPresent }}` • Your order shall be delivered on `{{ invoice.deliveryDate}}`. • Orders delivered can be returned within 10 days of delivery. `{{else}}` • Your order shall be delivered within the next 7 days. • Orders delivered can be returned within 10 days from the date of delivery.	Delivery terms: • Your order will be delivered on 23-03-2023. • Orders delivered can be returned within 10 days of delivery.

Conditions with tables

Doc Gen enables you to conditionally render any content including tables, images, and so on. {{ if invoice.customerId isPresent }}

Id	Name	Qty	Price
`{{tablerow item in invoice.items}}`
`{{item.id}}`	`{{item.name}}`	`{{item.quantity}}`	`{{item.price}}`
`{{endtablerow}}`

{{ endif }}

Conditions inside tables

Doc Gen enables you to conditionally render content with a column in a table. Examples

Id	Name	Qty	Price
`{{ tablerow item in invoice.items }}`
`{{ item.id}}`	`{{ item.name}}`	`{{ item.quantity}}`	`{{ if item.price isPresent}}{{item.price}}{{ else }}-{{ endif }}`
`{{ endtablerow }}`

Skip table rows based on conditions

When you generate documents from arrays of data, such as invoices, statements, or packing lists, you often need to include only the rows that meet certain business rules. For example, you might want to hide line items that are out of stock, below a threshold, or flagged in a particular way. Use the skip-row-if modifier to attach a condition to a table row template. When Box Doc Gen generates the document, it evaluates each item in the source array against the condition:

If the condition is true, Box Doc Gen discards the entire row, and the row doesn’t display in the output.
If the condition is false, the row renders as usual.

This is a row-level operation. Even though you add the modifier to a single field, it removes the whole row: every column in that row is dropped, not only the field that has the modifier. The following JSON serves as input for the examples:

{
  "invoice":{
    "number": "Inv1203",
    "date": "13-03-2023",
    "customerId": "90158",
    "currency": "$",
    "amount": 6560.50,
    "items": [
      {
        "id": 1,
        "date": "13-03-2023",
        "name": "A4 Papers",
        "type": "Standard",
        "quantity": 100,
        "price": 29,
        "amount": 2900
      },
      {
        "id": 2,
        "date": "14-03-2023",
        "name": "Ink cartridge",
        "type": "Fragile",
        "quantity": 40,
        "price": 39,
        "amount": 1560
      },
      {
        "id": 3,
        "date": "15-03-2023",
        "name": "Adhesive tape",
        "type": "Standard",
        "quantity": 20,
        "price": 30,
        "amount": 600.50
      },
      {
        "id": 4,
        "date": "16-03-2023",
        "name": "Desk lamp",
        "type": "Fragile",
        "quantity": 60,
        "price": 25,
        "amount": 1500
      }
    ]
  }
}

Example 1: Skip rows based on a single condition The following template skips every item with the type Fragile.

Item id	Date	Quantity	Amount
`{{ tablerow item in invoice.items }}`
`{{ item.id}}`	`{{ item.date}}`	`{{ item.quantity}}`	`{{item.amount::skip-row-if(item.type == “Fragile”)}}`
`{{ endtablerow }}`

The output table omits items 2 and 4:

Item id	Date	Quantity	Amount
1	13-03-2023	100	2900
3	15-03-2023	20	600.50

Example 2: Skip rows based on multiple conditions You can chain conditions with the AND and OR operators. The following template skips items with the type Fragile and a quantity of 50 or less.

Item id	Date	Quantity	Amount
`{{ tablerow item in invoice.items }}`
`{{ item.id}}`	`{{ item.date}}`	`{{ item.quantity}}`	`{{item.amount::skip-row-if(item.type == “Fragile” AND item.quantity <= “50”)}}`
`{{ endtablerow }}`

The output table omits only item 2. Item 4 is also Fragile, but its quantity is greater than 50, so it renders:

Item id	Date	Quantity	Amount
1	13-03-2023	100	2900
3	15-03-2023	20	600.50
4	16-03-2023	60	1500

7. Calculations

Box Doc Gen templates support dynamic calculations. You can either write the computation code to the tagging language manually, or use the Box Doc Gen Template Creator add-in. Sample code calculations include:

Invoice: Determining the net invoice amount from individual line items. Example: Sum (Individual Line item amounts in the invoice)
Purchase order: Capping the maximum sourcing amount. Example: 5% * Net Order Value
Sales contracts: Defining penalty on SLA breach. Example: 10% * Total Sales Value

Supported operations

Arithmetic operations	Aggregation operations
%	Percent
+	SUM
*	AVERAGE
-	COUNT

The following JSON serves as input for adding calculations to the document template.

{
  "invoice":{
    "number": "Inv1203",
    "invoiceDate": "13-03-2023, 12:10 PM",
    "deliveryDate": "23-03-2023",
    "customerId": "90158",
    "currency": "$",
    "taxRate": 3,
    "taxAmount": 151.8,
    "shippingCharge": 15,
    "grossAmount": 5060,
    "penaltyRate": 10,
    "billCap": 25,
    "items": [
      {
        "id": 1,
        "name": "A4 Papers",
        "quantity": 100,
        "price": 29,
        "amount": 2900
      },
      {
        "id": 2,
        "name": "Ink  cartridge",
        "quantity": 40,
        "price": 39,
        "amount": 1560
      },
      {
        "id": 3,
        "name": "Adhesive tape",
        "quantity": 20,
        "price": 30,
        "amount": 600
      }
    ]
  }
}

Examples:

Use case	Document template	Output document
To calculate net amount from the given Gross Amount and Tax Amount Arithmetic calculation	Net Amount: `{{ invoice.grossAmount + invoice.taxAmount}}`	Net Amount: 5211,8 Annotation: 5060 (grossAmount) + 151.8 (taxAmount)
To calculate net amount from the given Gross Amount, Tax Rate and Shipping Charge Arithmetic calculation	Net Amount: `{{ invoice.grossAmount + invoice.taxAmount + invoice.shippingCharge}}`	Net Amount: 5226.8 Annotation: 5060 (grossAmount) + 151.8 (taxAmount) + 15 (shippingCharge)
To calculate tax amount from the given Tax Rate and Gross Amount Arithmetic calculation	Tax Amount: `{{ invoice.taxRate % * invoice.grossAmount}}`	Tax Amount: 151.8 Annotation: 3% (taxRate) 5060 (grossAmount)*
To calculate gross amount from individual line item amounts Aggregation calculation	Gross Amount: `{{ $sum(invoice.items.amount) }}`	Gross Amount: 5060 Annotation: Sum (2900+1560+600)
To calculate number of line items Count calculation	Count: `{{ $count(invoice.items.amount) }}`	Count: 3
To calculate average of line items	Average Amount: `{{ $average(invoice.items.amount) }}`	Average Amount: 1686.66
To calculate net amount from the given Line Item Amount, and Tax Rate Arithmetic + Aggregation calculation	Net Amount: `{{ $sum(invoice.items.amount) + invoice.taxRate % *$ sum(invoice.items.amount)}}`	Net Amount: 5211,8 Annotation: Sum (2900+1560+600) + 3% Sum (2900+1560+600)*

8. Box Sign template tags

Box Sign template tags can be added to the Box Doc Gen template for the output document created via Box Doc Gen to be sent for e-signature. The table below lists the tags available in the Box Doc Gen Template Creator add-in and the tagging script.

Field	Box Sign’s template code	Supported via tagging script	Supported via add-in
Text field	`[[t\|0]]`	Yes	Yes
Date field	`[[d\|0]]`	Yes	Yes
Checkbox field	`[[c\|0]]`	Yes	Yes
Signature field	`[[s\|0]]`	Yes	Yes
Stamp field type	`[[st\|0]]`	Yes	Yes
Initials field type	`[[i\|0]]`	Yes	Yes
Name field type	`[[n\|0]]`	Yes	Yes
First name field type	`[[fn\|0]]`	Yes	Yes
Last name field type	`[[ln\|0]]`	Yes	Yes
Company field type	`[[co\|0]]`	Yes	Yes
Email field type	`[[e\|0]]`	Yes	Yes
Title field type	`[[ti\|0]]`	Yes	Yes
For an attachment field type	`[[a\|0]]`	Yes	Yes

​1. Text tags

​Optional tags

​Default values

​Formatting text tags

​Rich text

​2. Image tags

​1. Upload the image file to Box

​2. Author the Doc Gen template

​Generating documents from a placeholder image

​Generating documents with HTML images

​3. Create the JSON payload to generate the document

​Generating documents from a placeholder image

​Generating documents with HTML images

​4. Make a document generation request

​3. Table tags

​Document Template

​Output

​4. Nested tables

​Example 1: List the items inside the category row

​Example 2: Display only the first expense

​Example 2.1: Display one row per item for every expense

​Example 3: Add the event name, date, and currency

​Example 4: Display every category name on each item row

​Example 5: Add extra items for each line item

​Example 6: Create one table per expense

​5. List tags

​Formatting lists

​6. Conditions

​Supported conditions and operators

​Conditions with tables

​Conditions inside tables

​Skip table rows based on conditions

​7. Calculations

​8. Box Sign template tags

1. Text tags

Optional tags

Default values

Formatting text tags

Rich text

2. Image tags

1. Upload the image file to Box

2. Author the Doc Gen template

Generating documents from a placeholder image

Generating documents with HTML images

3. Create the JSON payload to generate the document

Generating documents from a placeholder image

Generating documents with HTML images

4. Make a document generation request

3. Table tags

Document Template

Output

4. Nested tables

Example 1: List the items inside the category row

Example 2: Display only the first expense

Example 2.1: Display one row per item for every expense

Example 3: Add the event name, date, and currency

Example 4: Display every category name on each item row

Example 5: Add extra items for each line item

Example 6: Create one table per expense

5. List tags

Formatting lists

6. Conditions

Supported conditions and operators

Conditions with tables

Conditions inside tables

Skip table rows based on conditions

7. Calculations

8. Box Sign template tags