---
title: "Create list Attributes"
slug: "create-list-attributes"
updated: 2025-08-28T09:18:07Z
published: 2025-08-28T09:18:07Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.lightico.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create list Attributes

This article explains list Attributes and how to create them in Lightico settings.

## What is a list Attribute

While a basic Attribute can hold only one value at a time, a list Attribute can hold multiple values simultaneously.

For example, a basic number Attribute called **account_number** can hold only one account number per session. However, you may need to obtain a list of account numbers. In that case you could bind the **account_number** Attribute to a list Attribute called, for example, **bank_accounts** enabling you to hold multiple account numbers.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/List_attributes.png)

### A list of complex Attributes

You can also create a list of [complex Attributes](/v1/docs/create-complex-attributes) where each item on the list includes multiple data points.

For example, for the **bank_accounts**list Attribute you can associate a complex Attribute called **bank_account_information**which contains not only the account number, but also the type of account, date of opening the account, and current balance.

Now each item in the list holds four Attribute values.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/image(87).png)

### Where can you use list Attributes

List Attributes are used in a collaboration session in the following ways:

- **Form**- Add list Attribute fields to a [Form](/v1/docs/create-forms#add-attribute-fields-to-the-form) to obtain lists of customer information.
- **Dynamic Document** - Include the information obtained with the Form in a [Dynamic Document](/v1/docs/add-dynamic-elements-to-a-dynamic-document#add-list-attributes) where it appear in a dynamic table that expands to fit the number of items in the list.
- **Event**- All values are available for retrieval in the [Workflow completed event](https://developers.lightico.com/docs/api-reference/hx4t0ssicfwdy-events#workflow-completed) in the **customerData**parameter.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/2024-07-17_11-04-47.PNG)

Rendered Dynamic Document based on a list Attribute

## How to create a list Attribute

> [!NOTE]
> Note
> 
> Currently, list Attributes are created in the Form builder or HTML builder and cannot be created from the Attributes mapping page.

**To create a list Attribute:**

1. On the Form builder page, click the add (**+**) icon and select **Attribute**.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/2024-07-10_16-54-38.PNG)

The Select Attribute window opens.
2. Click **Create Attribute** and select **List**.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/2024-07-10_17-27-39.PNG)

The Create Attribute window opens.
3. Type a name and label for the Attribute.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/image(68).png)
4. Click in the **Select Attribute** field.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/image(69).png)
5. Select an Attribute to be repeated in the list.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/2024-07-10_17-49-32.PNG)
6. Click **Save**. The list Attribute is saved and can be used in all [supported areas](/v1/docs/create-list-attributes#using-list-attributes) of the Lightico platform.

## Customer experience

The customer Form requires the customer to enter the number of mandatory instances of the Attribute (in the illustration below the minimum is 3). They can then click **Add item**to add instances up until the defined maximum limit. The customer can also remove an optional instance by clicking the **X**.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/2024-07-11_15-57-30.PNG)

A list Attribute associated with a complex Attribute appears on the form as a list of instances of the group of Attributes. Each instance shows all Attributes in the group. Clicking **Add item** adds another instance of the whole group.

![](https://cdn.document360.io/473bb8c5-ff1b-4930-8109-2321ac6ab967/Images/Documentation/2024-07-11_15-58-30.PNG)