Build row components

Rows are horizontal layout components. They contain an array of other components and define the location of those components on the page. No components exist outside a row (except page, header, body, and footer).

The following are characteristics of rows:

• Do not appear on invoices.
• Can be an unlimited number on a page.
• Reside, by default, above and below other rows. They cannot reside to the right or left of each other.
• Contain one or more of the following layout components:
  • One or more cells (required).
  • Horizontal spacers to separate cells (optional).
• Can be separated with vertical spacer components.
• Cannot contain rows, but can contain cells that contain rows.

note

You can create more than one active version of an invoice template per locale, and use conditional expressions to determine which fields appear on a version of an invoice template. You can only use conditional expressions in templates that you create or that you copy from a marketplace-provided default template. You cannot add conditional expressions to marketplace default templates.

Prerequisites

You can add row components to header sections, footer sections, or cell components.

• Build headers
• Build footers
• Build cell components

Default template JSON sample

In the Appdirect Template_EN_US default template, see lines 205-235.

To download the default template

📝 Note: If the AppDirect logo appears in the upper-left corner of the page, when Manage > Marketplace appears in this topic, click the grid icon > Switch to | Store, instead.

1. Go to Manage > Marketplace > Settings > Invoice templates > Appdirect Template_EN_US | Gear icon | Download JSON .

Row component JSON schema

{
    "type": "row",
    "style": { },
    "properties": {
        "visible": <true | false>
    },
    "components": [
        {
        // Can contain Components of 'type:cell or horizontalSpacer' only
        }
    ]
}

Elements to populate row components

Element			Type	Description
row			object	Defines styles and behaviors for a row. Rows can contain cells which can contain content that appears on invoices.
	type		string	Required. Defines the component type as row. Valid value: row
	style		object	Required. Defines formatting for the row. Valid values: HTML element names and CSS styles for the named HTML element. All HTML styles. Only relevant styles that the Invoice Builder can render appear in the user interface preview and the PDF. Examples: "font-size": "9px", "font-family": "Arial"
	properties		object	Required. Define visibility.
		visible	boolean	Required. Defines whether component appears on invoices. Valid values: true | false
	components		array	Required. Cells and horizontal spacers, both style components, that define the location of content in the row. At least one cell is required. Valid components: cell, horizontalSpacer For information on cell and horizontal spacer, see: Build cell components Build horizontal spacers