List tagging element

Use the List tagging element to display repeating sections in your document based on a collection of data records from your Data Source. List tagging elements are ideal for rendering tables, lists, or other repeating content where each item corresponds to a record in the collection.

Prerequisites

Bind List tagging element to data

Before you can configure sorting and repeat options, bind the List tagging element to a data field that represents a collection of data records. For detailed steps, see Bind tagging element to data.

TIP

To use only select records from the collection, bind the List tagging element to a Power Fx expression using Filter function. An example of a filter expression to select only Quote Lines where Quantity is larger than 1: Filter(Quote.QuoteLines, Quantity > 1)

Work with Data Context in List elements

When you work with List tagging elements, you will usually nest other tagging elements inside them to display specific fields from each record in the collection. When you bind a List tagging element to a collection of records, each nested tagging element operates within the context of the current record being processed. You will typically use Data Context as the binding source for nested tagging elements inside a List tagging element.

Example: Display line item details

To display item details for each line in a quote:

  1. Insert a List tagging element and bind it to the collection (e.g., Quote.QuoteLines).
  2. Inside the list content, insert Field tagging elements for the fields you want to display (e.g. Quantity).
  3. Bind each Field tagging element using Data Context as the Source and select the field from the list context.
  4. Each iteration of the list automatically provides the values of the current record (e.g., current QuoteLine) for fields, bound to Data Context.

This approach simplifies template design and makes bindings easier to manage.

Configure sorting

Control the order in which list items appear in the generated document by adding sorting rules.

  1. Select the List tagging element to view its properties.
  2. In the Properties pane, locate the Sorting property and choose the sorting button to open the Sorting dialog.
  3. In the Sorting dialog, you can add multiple sorting rules to sort by multiple fields or remove sorting rules for how records should be ordered. Use the up and down arrows to change the priority of sorting rules.
  4. Select field Value based on which list will be sorted and choose the field or enter a PowerFx expression to use as sorting value.
  5. Select SortOrder to define whether to sort list in Ascending or Descending order.
  6. Choose OK to apply the sorting configuration.
  7. Review results in Live Preview pane.

Sorting dialog showing interface for configuring sorting rules with options to add multiple sort criteria.

Configure Repeat Mode

By specifying the Repeat Mode property, you can control how the List tagging element repeats its content in the document structure. This is particularly useful when the List tagging element wraps different types of content, such as table rows, cells, or any other type of content.

  1. Select the List tagging element to view its properties.
  2. In the Properties pane, locate the Repeat Mode property and select one of the options. For example, if the List tagging element wraps an entire table row and you pick Table Row for the Repeat Mode, new table rows are created for each record in the collection.
  3. If the List tagging element wraps a single table cell, and you pick Table Cell for the Repeat Mode, new table cells are created for each record in the collection, in a left-to-right, top-to-bottom manner.
  4. If the List tagging element wraps a table cell, and you pick Arbitrary Content for the Repeat Mode, content for all records will be repeated and placed inside that single cell.
TIP

You can repeat basically any content, not just parts of a Word table. Select a paragraph, part of a page or whole page(s), that need to be repeated and insert a List tagging element to wrap it in the List.

Properties pane showing the Repeat Mode dropdown with Table Row, Paragraph, and Content options.

Apply visual formatting

You can specify visual formatting rules on the List tagging element to control the visual appearance of the whole List content in the generated document in a dynamic, data-driven manner. To control each repeated part of content, use visual formatting on tagging elements contained in the List tagging element. For detailed steps, see Apply visual formatting to tagging elements.

Next steps