# Table row generator

:::callout{theme="neutral"}
This widget is only available for [document templates](../templates-overview/index.md).
:::

The **Table row generator** enables dynamically generating a row for each object in an object set that is passed to a Notepad document template. The Table row generator is very similar to the [**Section generator**](../widgets-section-generator/index.md#connect-embedded-sections-with-generator), but instead of generic sections, the Table row generator returns rows and can only be used in Notepad tables.

![notepad\_row\_generator](../../../assets/eceee6eb0147484778a3631f7f6b06241f28dfe7920271ef5552e996084be319.webp)

The row generator can be inserted into a regular Notepad table via the table right-click menu or table **Insert** operations located in the toolbar. Alternatively, select **+ Add Widget** or type `/` in a paragraph field to open the [widget insertion menu](../embed-widgets/index.md#from-a-document), from which you can insert a Table row generator that is prefilled with one regular row and one generator row.

## Connect embedded widgets with the Table row generator

To connect an embedded widget's input parameter with its surrounding **Table row generator**, set the input to `Object from generator`. The `Object from generator` input item will be automatically selectable for widgets inside generators that accept object template inputs.

The figure below shows an example for an [object property](../widgets-object-property/index.md).

![notepad\_row\_generator\_connection](../../../assets/d8d455cdf6e5a89aa3b544e1040457ab5e427ee0885672e1e46edf16b45a08dc.webp)

## Sort objects with the Table row generator

To sort the objects that are returned from a generator, use the **Sorting** controls. Select an object property to sort by from the `Sort by` dropdown. The number of objects that can be sorted is **capped at 2000**.

The figure below shows an example of sorting Airline objects by the `Number of Aircraft` property.

![notepad\_widgets\_generator\_sort](../../../assets/844fc14d7a5794c106509a188da8dd4fec86e33ad593816ac7c4a0c91bc4cd39.webp)

## Template configuration

* **Generator object set RID:** An object set to pass to the Table row generator. The Table row generator will generate a table row for each object in this set. The number of objects that can be passed is currently **capped at 100 objects**.

## Nested table row generators

Table row generators can be [nested within a top-level section generator](../widgets-section-generator/index.md#nested-generators). Nested table row generators can be configured to generate over an object set template input, or over first-degree linked objects of the top-level generator object.

![A Notepad row generator linked objects generator.](../../../assets/72a23029a5df03db671fe5acf2f67ee93673ae4b1a7fa4c0a0c6c0f539578bb1.webp)

## Table row generator object limits

By default, the generation limit for top-level table row generators is set to a maximum of 100 objects. For table row generators nested within a section generator, the limit is set to a maximum of 100 objects. Generating rows from a large set of objects can negatively impact template generation performance and document loading performance for the generated document.