---
title: "List of Items: Create and Use Tables in Your Templates"
description: Learn how to create List of items references in Precisely, add repeating rows to documents, configure data sources, and use summaries to calculate totals and item counts.
---

[Skip to content](https://help.precisely.se/en/list-of-items#main-content)

[![Precisely\_logo\_black-1](https://help.precisely.se/hs-fs/hubfs/Precisely_logo_black-1.png?width=116&height=40&name=Precisely_logo_black-1.png)](https://preciselycontracts.com/)

Open main navigation

Close main navigation

- [Go to preciselycontracts.com](https://preciselycontracts.com/)

[Go to preciselycontracts.com](https://preciselycontracts.com/)

 Hello! How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.precisely.se/en?hsLang=en)
2. [Automated Templates & Documents](https://help.precisely.se/en/automated-templates-documents?hsLang=en)
3. [Building & Managing Templates](https://help.precisely.se/en/automated-templates-documents?hsLang=en#building-managing-templates)

# List of Items: Create and Use Tables in Your Templates

## Learn how to create lists of items in your templates to collect information in a structured table

Learn how to create lists of items in your templates, let users add multiple rows when drafting, and use the information in your documents, approval workflows, and conditions.

The **List of items** reference type allows you to collect information in a structured table, with one row for each product, service, or other item.

Instead of creating separate questions for each item, you can define the columns once and let users add as many rows as needed when drafting a project.

For example, you could use a list to collect:

- Products included in an order
- Services included in an agreement
- Items and quantities in a purchase agreement
- Fees, prices, and discounts
- Deliverables included in a contract

You can also use the information in the list to calculate totals, set approval rules, and automatically populate documents.

### **Item vs. List of items references**

Precisely offers two reference types for working with items:

- **Item:** Use this to capture information about a single item, with each field available as an individual reference in your template.
- **List of items:** Use this to capture multiple items in a repeating table, where each item is added as a separate row with the same fields. You can also use summaries, such as totals and item counts.

 

### 1. Create a List of Items reference

To get started, create a new reference in your template.

1. Open your template and select **New reference**.
2. Under **Reference type**, select **List of items**.
3. Enter a question for the list, for example, *Which products are included?*
4. Give the reference a name, for example, *Order lines*.
5. Define the columns you want to include in the list.

 

![](https://272d7bb8-a067-49c7-8767-f034ea8e2469.frame.claudeusercontent.com/_f/1792597085-aaef/img/01-columns.png)

 

##### Configure columns

For each column, configure the following:

- **Label:** The name of the field, such as Product name, Quantity, or Price. The reference name and API key are generated from the label.
- **Type:** Choose the type of information the field should contain: 
    - Short text
    - Long text
    - Numeric
    - Date
    - Multiple choice
- **Required:** Decide whether the field must be completed for each item.
- **Order:** Arrange the columns in the order you want them to appear.

You can also set a minimum number of rows that must be added to the list.

**Important:** Once a project has been created using the template, you cannot remove or rename existing columns or change their data types. You can still update labels, column order, multiple-choice options, formatting, and required settings, as well as add new columns.

 

### 2. Add the list to your document

Once you've created the reference, you can insert it into your document as a table.

![](https://help.precisely.se/hs-fs/hubfs/image-png-Nov-16-2026-08-23-52-0302-AM.png?width=670&height=332&name=image-png-Nov-16-2026-08-23-52-0302-AM.png)

1. Open the document editor in your template.
2. Insert the List of items reference where you want the table to appear.
3. Choose which columns should be included in the table and arrange them in the order you want.
4. If needed, customise the column headers shown in the document.
5. Choose whether to include a total row.

**Note:** If you add new columns when editing a List of items reference, they won't be selected for the document table by default. To include them, edit the table and select the checkbox next to each new column.

![](https://help.precisely.se/hs-fs/hubfs/Screenshot%202026-11-16%20at%2009-19-52-png.png?width=437&height=533&name=Screenshot%202026-11-16%20at%2009-19-52-png.png)

##### Add a total row

You can add a total row to display calculated values for numeric columns. This is useful for things like quantities, prices, or other values that need to be added together.

##### Choose what happens when the list is empty

You can configure how the document should behave if no items have been added:

- **Omit the table:** The table won't appear in the generated document.
- **Show headers only:** The table will appear with its column headers, but without any rows.

 

### 3. Use summaries from the list

List of items references can calculate summary references across all the rows in the list. This allows you to use information from multiple items elsewhere in your template without needing to reference each row individually. 

Available summaries include:

- **Number of items:** Counts the number of rows in the list.
- **Sum:** Adds together the values in a numeric column.
- **Highest:** Returns the highest value in a numeric column.
- **Lowest:** Returns the lowest value in a numeric column.

![](https://help.precisely.se/hs-fs/hubfs/Screenshot%202026-11-16%20at%2009-21-48-png.png?width=362&height=430&name=Screenshot%202026-11-16%20at%2009-21-48-png.png)

You can use these summary references in:

- Document text
- Approval rules
- Inclusion rules
- Conditions
- Formulas

![](https://help.precisely.se/hs-fs/hubfs/Screenshot%202026-11-16%20at%2010-49-05-png-1.png?width=670&height=338&name=Screenshot%202026-11-16%20at%2010-49-05-png-1.png)

For example, you could use the sum of a Price column to display the total value of all items in the list, or use the number of items summary to show how many products have been added.

**Note:** Rules and conditions can use summaries of the list, but cannot evaluate individual rows or their values separately.

### 4. Add items when drafting a project

When drafting a project using a template with a List of items reference, the reference appears as a table where you can add and manage individual items.

1. Find the List of items section on the questionnaire page.
2. Select **Add line item** to create a new row.
3. Complete the fields for that item.
4. Repeat to add more items to the list.
5. Remove individual rows if they are no longer needed.

Each row represents one item and contains the same fields configured in the template.

![](https://help.precisely.se/hs-fs/hubfs/Screenshot%202026-11-16%20at%2009-26-53-png.png?width=670&height=236&name=Screenshot%202026-11-16%20at%2009-26-53-png.png)

![](https://help.precisely.se/hs-fs/hubfs/Screenshot%202026-11-16%20at%2010-25-17-png-1.png?width=670&height=278&name=Screenshot%202026-11-16%20at%2010-25-17-png-1.png)

##### Validation

Depending on how the columns are configured, you may see validation messages if:

- A required field has been left empty.
- A numeric field contains a value that isn't a valid number.
- A date field contains an invalid date.
- The list contains fewer rows than the configured minimum.

Make sure all required fields and minimum row requirements are satisfied before completing the draft.

 

### 5. View the generated document

When the project document is generated, the List of items reference is displayed as a table using the columns and settings configured in the template.

![](https://help.precisely.se/hs-fs/hubfs/Screenshot%202026-11-16%20at%2010-33-23-png.png?width=670&height=236&name=Screenshot%202026-11-16%20at%2010-33-23-png.png)

The table includes the items added during drafting, with each item displayed on its own row. Any configured summaries or total rows are calculated using the values entered across the list.

This makes List of items useful when a document needs to include several products, services, pricing details, or other information that follows the same structure for each entry.

### 6. Populate list items using a data source

You can connect a List of items reference to a data source to automatically populate fields when someone selects an item from a catalogue or other connected source.

For example, if you're creating a list of products, you could let drafters select a product from a catalogue and automatically populate its name, unit price, and product type.

[Learn more about our API references/data source functionality here.](https://help.precisely.se/en/how-to-use-api-references-in-precisely?hsLang=en)

- [The Precisely Platform: Key Features & Tools](https://help.precisely.se/en/the-precisely-platform-key-features-tools?hsLang=en)
- [Automated Templates & Documents](https://help.precisely.se/en/automated-templates-documents?hsLang=en#main-content)

    - [Building & Managing Templates](https://help.precisely.se/en/automated-templates-documents?hsLang=en#building-managing-templates)
    - [Working with References](https://help.precisely.se/en/automated-templates-documents?hsLang=en#working-with-references)
    - [Conditional Logic & Automation](https://help.precisely.se/en/automated-templates-documents?hsLang=en#conditional-logic-automation)
    - [Formatting & Content Styling](https://help.precisely.se/en/automated-templates-documents?hsLang=en#formatting-content-styling)
    - [Collaboration & Negotiation](https://help.precisely.se/en/automated-templates-documents?hsLang=en#collaboration-negotiation)
    - [Document Management & Versioning](https://help.precisely.se/en/automated-templates-documents?hsLang=en#document-management-versioning)
    - [Precisely Archive](https://help.precisely.se/en/automated-templates-documents?hsLang=en#precisely-archive)
- [Control & Compliance](https://help.precisely.se/en/control-compliance?hsLang=en#main-content)

    - [Access & Permissions](https://help.precisely.se/en/control-compliance?hsLang=en#access-permissions)
    - [Approval Automation](https://help.precisely.se/en/control-compliance?hsLang=en#approval-automation)
    - [Monitoring & Logs](https://help.precisely.se/en/control-compliance?hsLang=en#monitoring-logs)
    - [Reviewer Permissions & Notifications](https://help.precisely.se/en/control-compliance?hsLang=en#reviewer-permissions-notifications)
    - [Security & Authentication](https://help.precisely.se/en/control-compliance?hsLang=en#security-authentication)
    - [Template & Draft Control](https://help.precisely.se/en/control-compliance?hsLang=en#template-draft-control)
- [Precisely's AI Features](https://help.precisely.se/en/preciselys-ai-features?hsLang=en#main-content)

    - [Precisely's AI Assistant](https://help.precisely.se/en/preciselys-ai-features?hsLang=en#preciselys-ai-assistant)
- [FAQs & Troubleshooting](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#main-content)

    - [Getting Started & Account Settings](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#getting-started-account-settings)
    - [Draft & Sign](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#draft-sign)
    - [E-Signing](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#e-signing)
    - [Users & Permissions](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#users-permissions)
    - [Language Settings](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#language-settings)
    - [General Information](https://help.precisely.se/en/faqs-troubleshooting?hsLang=en#general-information)
- [Integrations](https://help.precisely.se/en/integrations?hsLang=en#main-content)

    - [AI Features](https://help.precisely.se/en/integrations?hsLang=en#ai-features)
    - [Precisely's API](https://help.precisely.se/en/integrations?hsLang=en#preciselys-api)
    - [Precisely's Microsoft Outlook Integration](https://help.precisely.se/en/integrations?hsLang=en#preciselys-microsoft-outlook-integration)
    - [Custom SMTP](https://help.precisely.se/en/integrations?hsLang=en#custom-smtp)
- [Electronic Signature](https://help.precisely.se/en/electronic-signature?hsLang=en#main-content)

    - [Signing Providers & Methods](https://help.precisely.se/en/electronic-signature?hsLang=en#signing-providers-methods)
    - [National eID Integrations](https://help.precisely.se/en/electronic-signature?hsLang=en#national-eid-integrations)
- [Pricing, Privacy & Terms](https://help.precisely.se/en/pricing-privacy-terms?hsLang=en)
- [New in Precisely](https://help.precisely.se/en/new-in-precisely?hsLang=en)

[![Chill listening crop-3](https://help.precisely.se/hubfs/Precisely_logo_black.svg "Chill listening crop-3")](https://www.preciselycontracts.com)

Precisely's Help Center

Copyright © 2025, Precisely AB